# Agent Week Plan 一周开发计划

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

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

## 执行标记规则

未完成：

```md
- [ ] 建立 AgentAsset 数据模型
```

完成后：

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

执行要求：

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

## 文档顺序

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

1. [MASTER_TODO.md](./MASTER_TODO.md)
2. [day_1_foundation_models.md](./day_1_foundation_models.md)
3. [day_2_rule_center_integration.md](./day_2_rule_center_integration.md)
4. [day_3_semantic_ontology_mvp.md](./day_3_semantic_ontology_mvp.md)
5. [day_4_orchestrator_runtime.md](./day_4_orchestrator_runtime.md)
6. [day_5_user_agent_mvp.md](./day_5_user_agent_mvp.md)
7. [day_6_hermes_mvp.md](./day_6_hermes_mvp.md)
8. [day_7_hardening_demo_acceptance.md](./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 命名必须稳定，不能一天一个风格。
- [ ] 数据模型新增字段必须写清楚用途。
- [ ] 前端状态、空态、错误态、加载态都要覆盖。
- [ ] 每天结束必须能给出可运行证据。