feat: deliver agent foundation day 1

document/development/agent week plan/00_README.md

@@ -1,105 +1,51 @@
-# Agent Week Plan 一周开发计划
+# Agent Week Plan 一周开发路线图
 
-本目录是在 `document/development/agent plan` 架构文档基础上拆出的 7 天生产标准开发计划。
+本目录是 `agent_weekly_plan` 的路线图层，负责回答“这一周每天大概做什么、为什么这样排、每天交付什么”。
 
-这版文档不是概念说明，而是给 Codex 或开发人员逐项执行的 TODO 手册。执行时必须按顺序推进，每完成一项就在对应文档中标记。
+具体到字段、接口、服务、前端、测试和验收步骤的执行清单，不放在这里，而是放在：
 
-## 执行标记规则
+[../agent plan/weekly_execution_details/README.md](<../agent plan/weekly_execution_details/README.md>)
 
-未完成：
+## 两层文档分工
 
-```md
-- [ ] 建立 AgentAsset 数据模型
-```
+| 目录 | 职责 | 读者 |
+| --- | --- | --- |
+| `agent week plan` | 7 天路线图，每天只讲大开发点、交付物、验收门槛 | 产品、架构、排期、开发启动前 |
+| `agent plan` | 架构设计、协议、流程、每天具体执行 TODO | Codex、开发人员、评审人员 |
 
-完成后：
+## 使用方式
 
-```md
-- [x] ~~建立 AgentAsset 数据模型~~
-```
+1. 先读 [MASTER_TODO.md](./MASTER_TODO.md)，确认 7 天节奏。
+2. 进入当天 daily 文档，看当天主题、交付结果和验收门槛。
+3. 点击 daily 中的“对应执行细则”，进入 `agent plan/weekly_execution_details`。
+4. 在执行细则中按 `- [ ]` 一项一项开发。
+5. 完成细则后回到 daily 文档，确认当天是否达到交付门槛。
 
-执行要求：
+## 一周总体目标
 
-- [ ] 每次只处理一个最小 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：做加固、测试、演示、验收和下一阶段交接。
 
-## 文档顺序
+## 一周暂不完成
 
-先看总控清单，再进入每天的执行文档：
-
-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，只做本地构建、核心测试和验收脚本。
+- 完整 OCR 生产识别引擎。
+- 完整发票验真 MCP 深度接入。
+- 完整 LLM Wiki 向量检索。
+- 全量财务域数据打通。
+- 规则自动上线。
+- 完整 CI/CD 质量门禁。
 
 ## 生产底线
 
-以下底线不得被 MVP 名义绕过：
-
-- [ ] 所有写操作必须记录审计日志。
-- [ ] 所有 Agent 执行必须生成 `run_id`。
-- [ ] 所有规则必须有版本。
-- [ ] 未审核规则不能上线。
-- [ ] 高风险动作只能生成草稿或建议，不能自动提交。
-- [ ] 外部服务失败必须有降级结果。
-- [ ] 语义解析结果必须落库或落日志，便于回放。
-- [ ] 前端不能只写静态 UI，必须至少对接 Mock 或真实 API。
-
-## 每日固定流程
-
-上午：
-
-- [ ] 读取当天文档。
-- [ ] 检查前一天遗留阻塞。
-- [ ] 确认数据库模型、API、服务边界。
-- [ ] 完成后端主路径。
-
-下午：
-
-- [ ] 完成前端联调。
-- [ ] 接入 Agent 或 Orchestrator 流程。
-- [ ] 完成权限、审计、错误态。
-
-傍晚：
-
-- [ ] 运行测试和构建。
-- [ ] 按当天验收清单逐项验收。
-- [ ] 更新 TODO 完成状态。
-- [ ] 填写日终交接。
-
-## Codex 执行约束
-
-- [ ] 修改代码前先读相关文件，不凭空创建重复模块。
-- [ ] 优先复用现有 FastAPI、SQLAlchemy、Vue、PrimeVue 写法。
-- [ ] API 命名必须稳定，不能一天一个风格。
-- [ ] 数据模型新增字段必须写清楚用途。
-- [ ] 前端状态、空态、错误态、加载态都要覆盖。
-- [ ] 每天结束必须能给出可运行证据。
+- 所有写操作必须有审计日志。
+- 所有 Agent 执行必须生成 `run_id`。
+- 所有规则必须有版本。
+- 未审核规则不能上线。
+- 高风险动作只能生成草稿或建议，不能自动提交。
+- 外部能力失败必须有降级结果。
+- 语义解析结果必须可回放。