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

Agent Week Plan 一周开发路线图

本目录现在同时承接：

• 一周路线图
• 每天 daily 文档
• 每天的详细执行清单

原独立执行细则目录已合并进各 Day 文档，不再单独维护。

文档分工

目录	职责	读者
agent week plan	一周节奏、每天目标、验收门槛、详细执行清单、阻塞记录、日终交接	产品、架构、Codex、开发、验收
agent plan	架构设计、协议、流程、治理、标准模型、能力边界	架构、开发、评审

使用方式

1. 先读 MASTER_TODO.md，确认 7 天节奏和当前状态。
2. 打开当天 daily 文档。
3. 在同一份 daily 文档里按顺序阅读： 今天的大开发点 -> 当前完成情况 -> 当天验收门槛 -> 详细执行清单 -> 阻塞记录 -> 日终交接。
4. 如需设计依据，再跳到 agent plan 对应架构文档。
5. 完成一个最小项后，再把该项改成完成态，而不是代码写完就直接算过。

完成标记规则

未完成：

- [ ] 建立 AgentAsset 数据模型

完成后：

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

执行要求：

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

一周总体目标

• Day 1：先把资产、版本、审核、运行日志、审计日志等基础地基建好。
• Day 2：把任务规则中心和后端资产体系打通。
• Day 3：建立语义本体 MVP，让用户问题能变成稳定结构。
• Day 4：建立 Orchestrator，让请求能被统一路由、审计、降级。
• Day 5：建立 User Agent MVP，处理用户查询、解释和草稿生成。
• Day 6：建立 Hermes MVP，处理定时巡检、统计、知识和规则草稿。
• Day 7：做加固、测试、演示、验收和下一阶段交接。

一周暂不完成

• 完整 OCR 生产识别引擎。
• 完整发票验真 MCP 深度接入。
• 完整 LLM Wiki 向量检索。
• 全量财务域数据打通。
• 规则自动上线。
• 完整 CI/CD 质量门禁。

生产底线

• 所有写操作必须有审计日志。
• 所有 Agent 执行必须生成 run_id。
• 所有规则必须有版本。
• 未审核规则不能上线。
• 高风险动作只能生成草稿或建议，不能自动提交。
• 外部能力失败必须有降级结果。
• 语义解析结果必须可回放。