X-Financial/document/development/agent week plan/00_README.md

Agent Week Plan 一周开发计划

本目录是在 document/development/agent plan 架构文档基础上拆出的 7 天生产标准开发计划。

这版文档不是概念说明，而是给 Codex 或开发人员逐项执行的 TODO 手册。执行时必须按顺序推进，每完成一项就在对应文档中标记。

执行标记规则

未完成：

- [ ] 建立 AgentAsset 数据模型

完成后：

- [x] ~~建立 AgentAsset 数据模型~~

执行要求：

• 每次只处理一个最小 TODO。
• 完成后先自测，再改成 [x]。
• 改成 [x] 时，同时用 ~~ 画线。
• 不能因为代码写完就标完成，必须满足该 TODO 的验收证据。
• 遇到阻塞时，在当天文档的“阻塞记录”下新增一条说明。
• 每天收尾时更新当天文档的“日终交接”。

文档顺序

先看总控清单，再进入每天的执行文档：

1. MASTER_TODO.md
2. day_1_foundation_models.md
3. day_2_rule_center_integration.md
4. day_3_semantic_ontology_mvp.md
5. day_4_orchestrator_runtime.md
6. day_5_user_agent_mvp.md
7. day_6_hermes_mvp.md
8. day_7_hardening_demo_acceptance.md

一周总目标

• 建立规则、技能、MCP、任务的统一资产模型。
• 建立规则 Markdown 内容、版本、审核、上线状态的闭环。
• 建立语义本体 8 字段解析接口。
• 建立 Orchestrator 路由和 Agent Run Trace。
• 建立 User Agent 的查询、解释、流程辅助 MVP。
• 建立 Hermes 的定时风险巡检和日报 MVP。
• 建立基础权限分级、人工确认、审计日志。
• 建立最小评测集、手动验收脚本和演示流程。

一周暂不做

• 不做完整 OCR 生产识别引擎，只预留标准接口和 Mock 结果。
• 不做完整发票验真 MCP 深度接入，只做能力注册和 Mock 调用。
• 不做完整 LLM Wiki 向量检索，只做知识条目写入和读取骨架。
• 不做所有财务域数据全量打通，只覆盖报销、应收、应付的最小字段。
• 不做规则自动上线，规则只能生成草稿，必须人工审核。
• 不做完整 CI/CD，只做本地构建、核心测试和验收脚本。

生产底线

以下底线不得被 MVP 名义绕过：

• 所有写操作必须记录审计日志。
• 所有 Agent 执行必须生成 run_id。
• 所有规则必须有版本。
• 未审核规则不能上线。
• 高风险动作只能生成草稿或建议，不能自动提交。
• 外部服务失败必须有降级结果。
• 语义解析结果必须落库或落日志，便于回放。
• 前端不能只写静态 UI，必须至少对接 Mock 或真实 API。

每日固定流程

上午：

• 读取当天文档。
• 检查前一天遗留阻塞。
• 确认数据库模型、API、服务边界。
• 完成后端主路径。

下午：

• 完成前端联调。
• 接入 Agent 或 Orchestrator 流程。
• 完成权限、审计、错误态。

傍晚：

• 运行测试和构建。
• 按当天验收清单逐项验收。
• 更新 TODO 完成状态。
• 填写日终交接。

Codex 执行约束

• 修改代码前先读相关文件，不凭空创建重复模块。
• 优先复用现有 FastAPI、SQLAlchemy、Vue、PrimeVue 写法。
• API 命名必须稳定，不能一天一个风格。
• 数据模型新增字段必须写清楚用途。
• 前端状态、空态、错误态、加载态都要覆盖。
• 每天结束必须能给出可运行证据。