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

# Agent Week Plan 一周开发路线图

本目录是 `agent_weekly_plan` 的路线图层，负责回答“这一周每天大概做什么、为什么这样排、每天交付什么”。

具体到字段、接口、服务、前端、测试和验收步骤的执行清单，不放在这里，而是放在：

[../agent plan/weekly_execution_details/README.md](<../agent plan/weekly_execution_details/README.md>)

## 两层文档分工

| 目录 | 职责 | 读者 |
| --- | --- | --- |
| `agent week plan` | 7 天路线图，每天只讲大开发点、交付物、验收门槛 | 产品、架构、排期、开发启动前 |
| `agent plan` | 架构设计、协议、流程、每天具体执行 TODO | Codex、开发人员、评审人员 |

## 使用方式

1. 先读 [MASTER_TODO.md](./MASTER_TODO.md)，确认 7 天节奏。
2. 进入当天 daily 文档，看当天主题、交付结果和验收门槛。
3. 点击 daily 中的“对应执行细则”，进入 `agent plan/weekly_execution_details`。
4. 在执行细则中按 `- [ ]` 一项一项开发。
5. 完成细则后回到 daily 文档，确认当天是否达到交付门槛。

## 一周总体目标

- 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`。
- 所有规则必须有版本。
- 未审核规则不能上线。
- 高风险动作只能生成草稿或建议，不能自动提交。
- 外部能力失败必须有降级结果。
- 语义解析结果必须可回放。