feat: deliver agent foundation day 1

document/development/agent week plan/MASTER_TODO.md

@@ -1,119 +1,46 @@
-# Agent Week Plan 总控 TODO
+# Agent Week Plan 总览
 
-本文件用于控制 7 天开发顺序。每个大项完成后，再进入对应天的详细文档。
+本文件只放一周路线图，不放细节 TODO。具体执行步骤在 `agent plan/weekly_execution_details`。
 
-完成标记规则：
+## 快速浏览
 
-```md
-- [x] ~~已完成的任务~~
-```
+- HTML 总览：[agent_week_plan_html/index.html](<../agent_week_plan_html/index.html>)
+- Day 1 HTML：[agent_week_plan_html/day-1.html](<../agent_week_plan_html/day-1.html>)
 
-## Day 1：基础模型与工程骨架
+## 一周节奏
 
-- [ ] 阅读 `document/development/agent plan/01_overall_architecture.md`。
-- [ ] 阅读 `document/development/agent plan/02_semantic_ontology.md`。
-- [ ] 阅读 `document/development/agent plan/06_data_contracts_and_governance.md`。
-- [ ] 阅读 `document/development/agent plan/07_capability_registry.md`。
-- [ ] 阅读 `document/development/agent plan/08_permission_confirmation.md`。
-- [ ] 阅读 `document/development/agent plan/09_observability_and_trace.md`。
-- [ ] 完成统一资产模型 `AgentAsset`。
-- [ ] 完成资产版本模型 `AgentAssetVersion`。
-- [ ] 完成资产审核模型 `AgentAssetReview`。
-- [ ] 完成 Agent 运行日志模型 `AgentRun`。
-- [ ] 完成工具调用日志模型 `AgentToolCall`。
-- [ ] 完成语义解析日志模型 `SemanticParseLog`。
-- [ ] 完成审计日志模型 `AuditLog`。
-- [ ] 完成基础 API 路由骨架。
-- [ ] 完成种子数据。
-- [ ] 完成 Day 1 验收。
+| Day | 状态 | 主题 | 主要交付 | 快速视图 | 对应执行细则 |
+| --- | --- | --- | --- | --- | --- |
+| Day 1 | 已完成（2026-05-11） | 基础模型与工程骨架 | 资产、版本、审核、运行日志、审计日志、基础 API、最小财务数据源 | [HTML](<../agent_week_plan_html/day-1.html>) | [细则](<../agent plan/weekly_execution_details/day_1_foundation_models.md>) |
+| Day 2 | 未开始 | 任务规则中心联调 | 规则/技能/MCP/任务列表与详情、Markdown、版本、审核 | [HTML](<../agent_week_plan_html/day-2.html>) | [细则](<../agent plan/weekly_execution_details/day_2_rule_center_integration.md>) |
+| Day 3 | 未开始 | 语义本体 MVP | 8 字段语义解析、日志、评测入口 | [HTML](<../agent_week_plan_html/day-3.html>) | [细则](<../agent plan/weekly_execution_details/day_3_semantic_ontology_mvp.md>) |
+| Day 4 | 未开始 | Orchestrator 运行时 | 统一入口、路由、权限、工具调用、Trace | [HTML](<../agent_week_plan_html/day-4.html>) | [细则](<../agent plan/weekly_execution_details/day_4_orchestrator_runtime.md>) |
+| Day 5 | 未开始 | User Agent MVP | 用户问答、财务查询、规则解释、草稿生成 | [HTML](<../agent_week_plan_html/day-5.html>) | [细则](<../agent plan/weekly_execution_details/day_5_user_agent_mvp.md>) |
+| Day 6 | 未开始 | Hermes MVP | 定时任务、风险巡检、日报、知识候选、规则草稿 | [HTML](<../agent_week_plan_html/day-6.html>) | [细则](<../agent plan/weekly_execution_details/day_6_hermes_mvp.md>) |
+| Day 7 | 未开始 | 加固、演示和验收 | 回归、测试、演示脚本、交付说明 | [HTML](<../agent_week_plan_html/day-7.html>) | [细则](<../agent plan/weekly_execution_details/day_7_hardening_demo_acceptance.md>) |
 
-## Day 2：任务规则中心联调
+## 当前完成情况
 
-- [ ] 阅读 `document/development/agent plan/13_rule_formation_lifecycle.md`。
-- [ ] 阅读 `document/development/agent plan/07_capability_registry.md`。
-- [ ] 对接规则、技能、MCP、任务资产列表 API。
-- [ ] 对接资产详情 API。
-- [ ] 对接规则 Markdown 读取和保存 API。
-- [ ] 对接版本列表和版本切换 API。
-- [ ] 对接审核者信息和审核状态。
-- [ ] 对接规则上线前审核拦截。
-- [ ] 完成前端筛选、搜索、详情、弹窗状态。
-- [ ] 完成 Day 2 验收。
+- Day 1 已完成，后端基础模型、审计和最小财务数据源已可供 Day 2 前端联调使用。
+- Day 2 到 Day 7 保持原排期，下一步直接进入规则中心联调。
 
-## Day 3：语义本体 MVP
+## 关键依赖顺序
 
-- [ ] 阅读 `document/development/agent plan/02_semantic_ontology.md`。
-- [ ] 阅读 `document/development/agent plan/14_financial_document_canonical_model.md`。
-- [ ] 定义 8 个核心字段的数据结构。
-- [ ] 实现语义解析服务。
-- [ ] 实现语义解析 API。
-- [ ] 实现解析日志保存。
-- [ ] 实现场景、意图、对象、时间、指标、约束、风险、权限字段。
-- [ ] 接入 User Agent 查询入口。
-- [ ] 完成最小评测集。
-- [ ] 完成 Day 3 验收。
+1. Day 1 必须先完成，因为后面所有能力都依赖资产、版本、审核、日志。
+2. Day 2 必须在 Day 3 前完成，因为语义和 Agent 需要读取规则、技能、MCP、任务资产。
+3. Day 3 必须在 Day 4 前完成，因为 Orchestrator 依赖语义本体做路由。
+4. Day 4 必须在 Day 5 / Day 6 前完成，因为 User Agent 和 Hermes 都应该由 Orchestrator 调用。
+5. Day 5 和 Day 6 可以部分并行，但都必须遵守权限、审计、Trace。
+6. Day 7 不新增大功能，只做加固、验收和交接。
 
-## Day 4：Orchestrator 运行时
+## 最终验收
 
-- [ ] 阅读 `document/development/agent plan/04_orchestrator_and_runtime_flow.md`。
-- [ ] 阅读 `document/development/agent plan/08_permission_confirmation.md`。
-- [ ] 阅读 `document/development/agent plan/09_observability_and_trace.md`。
-- [ ] 实现 Orchestrator 入口服务。
-- [ ] 实现语义本体到 Agent 路由。
-- [ ] 实现权限级别判断。
-- [ ] 实现工具调用封装。
-- [ ] 实现运行 Trace。
-- [ ] 实现降级和错误返回。
-- [ ] 完成 Day 4 验收。
-
-## Day 5：User Agent MVP
-
-- [ ] 阅读 `document/development/agent plan/03_agent_responsibilities.md`。
-- [ ] 阅读 `document/development/agent plan/12_llm_wiki_knowledge_architecture.md`。
-- [ ] 实现用户自然语言入口。
-- [ ] 实现报销查询解释流程。
-- [ ] 实现应收账款查询解释流程。
-- [ ] 实现应付账款查询解释流程。
-- [ ] 实现规则引用解释。
-- [ ] 实现建议草稿输出。
-- [ ] 完成前端对话或操作入口。
-- [ ] 完成 Day 5 验收。
-
-## Day 6：Hermes MVP
-
-- [ ] 阅读 `document/development/agent plan/03_agent_responsibilities.md`。
-- [ ] 阅读 `document/development/agent plan/11_ocr_invoice_architecture.md`。
-- [ ] 阅读 `document/development/agent plan/15_feedback_learning_loop.md`。
-- [ ] 实现任务资产调度入口。
-- [ ] 实现每日风险巡检任务。
-- [ ] 实现每日报销/报账/账款统计任务。
-- [ ] 实现知识库维护任务。
-- [ ] 实现 OCR Mock 接入点。
-- [ ] 实现 Hermes 运行结果面板或 API。
-- [ ] 完成 Day 6 验收。
-
-## Day 7：加固、演示和验收
-
-- [ ] 回归 Day 1 到 Day 6 所有核心路径。
-- [ ] 补齐权限拦截。
-- [ ] 补齐审计日志。
-- [ ] 补齐错误态和空态。
-- [ ] 补齐评测用例。
-- [ ] 补齐演示数据。
-- [ ] 完成构建。
-- [ ] 完成一周交付说明。
-- [ ] 完成 Day 7 验收。
-
-## 一周最终验收
-
-- [ ] 能从任务规则中心看到规则、技能、MCP、任务。
-- [ ] 能打开规则详情，编辑 Markdown，查看版本，切换版本。
-- [ ] 未审核规则不能上线。
-- [ ] 能输入一句自然语言问题并得到语义本体 8 字段结果。
-- [ ] 能由 Orchestrator 路由到 User Agent。
-- [ ] 能由 Hermes 执行一次模拟定时任务。
-- [ ] 能查看 Agent Run Trace。
-- [ ] 能查看工具调用日志。
-- [ ] 能查看审计日志。
-- [ ] 能运行核心测试。
-- [ ] 能完成演示脚本。
+- 任务规则中心能看到规则、技能、MCP、任务。
+- 规则详情能编辑 Markdown、查看最近 5 个版本、切换版本。
+- 未审核规则不能上线。
+- 用户问题能解析出语义本体 8 字段。
+- Orchestrator 能路由到 User Agent 和 Hermes。
+- User Agent 能完成查询、解释、草稿生成。
+- Hermes 能执行一次风险巡检或日报任务。
+- AgentRun、ToolCall、AuditLog 都能追溯。
+- 有演示脚本和下一阶段交接文档。