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

Agent Plan 文档索引

本目录描述 X-Financial 后续要建设的双 Agent 财务智能架构。

核心目标：

• 建立一套共享的语义本体协议，统一理解用户问题、定时任务和规则触发上下文。
• 建设两套职责边界清晰的 Agent：
  • Hermes：后台数字员工，负责内循环定时任务、风险巡检、统计、知识维护。
  • 自建 Agent：用户流程助手，负责用户交互、流程操作、解释、查询、草稿生成。
• 建设 Agent Orchestrator，统一负责路由、权限、工具调用、审计和失败处理。
• 让规则中心、MCP、知识库、数据库查询和任务系统使用同一套语义协议。

与一周计划的关系

document/development/agent week plan 是一周开发路线图，只描述每天要完成的大方向和交付结果。

本目录是具体架构和执行细则，包含：

• 架构设计。
• 数据协议。
• Agent 职责。
• Orchestrator 流程。
• OCR、知识库、规则生命周期。
• 一周开发中每天对应的详细 TODO。

执行时按这个顺序阅读：

1. 先看 document/development/agent week plan/MASTER_TODO.md，确认今天做什么。
2. 再看本目录的架构文档，理解为什么这样做。
3. 最后进入 weekly_execution_details，按具体 TODO 开发。

推荐阅读顺序：

1. 01_overall_architecture.md
2. 02_semantic_ontology.md
3. 03_agent_responsibilities.md
4. 04_orchestrator_and_runtime_flow.md
5. 05_development_roadmap.md
6. 06_data_contracts_and_governance.md
7. 07_capability_registry.md
8. 08_permission_confirmation.md
9. 09_observability_and_trace.md
10. 10_evaluation_and_testset.md
11. 11_ocr_invoice_architecture.md
12. 12_llm_wiki_knowledge_architecture.md
13. 13_rule_formation_lifecycle.md
14. 14_financial_document_canonical_model.md
15. 15_feedback_learning_loop.md
16. weekly_execution_details/README.md

开发原则：

• 先语义协议，后 Agent 能力。
• 先只读和建议，后写入和流程动作。
• 先人工确认，后有限自动化。
• 所有财务关键动作必须可审计、可回滚、可追责。
• 所有 Agent 能力必须注册、分级、可评测、可追踪。