106 lines
3.8 KiB
Markdown
106 lines
3.8 KiB
Markdown
# 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 命名必须稳定，不能一天一个风格。
|
||
- [ ] 数据模型新增字段必须写清楚用途。
|
||
- [ ] 前端状态、空态、错误态、加载态都要覆盖。
|
||
- [ ] 每天结束必须能给出可运行证据。
|