docs: 新增agent开发文档和风险评估文档

document/development/agent/agent plan/13_rule_formation_lifecycle.md

@@ -0,0 +1,194 @@
+# 规则形成生命周期
+
+## 1. 定位
+
+规则不是凭空写出来的。
+
+它应来自：
+
+- 制度文档。
+- 历史审批。
+- 风险案例。
+- OCR 识别结果。
+- MCP 验真结果。
+- 用户反馈。
+- Hermes 分析。
+
+## 2. 总体闭环
+
+```text
+制度文档 / 历史审批 / 风险案例 / 用户反馈
+  ↓
+Hermes 分析
+  ↓
+规则候选
+  ↓
+人工审核
+  ↓
+规则 .md
+  ↓
+测试样例
+  ↓
+版本发布
+  ↓
+规则执行
+  ↓
+命中反馈
+  ↓
+规则优化
+```
+
+## 3. 规则候选结构
+
+```json
+{
+  "candidate_id": "",
+  "source_type": "policy_document",
+  "domain": "reimbursement",
+  "scenario": "invoice_validation",
+  "risk_signal": "duplicate_invoice",
+  "suggested_rule_name": "重复报销识别规则",
+  "rule_markdown_draft": "",
+  "evidence": [],
+  "confidence": 0.86,
+  "created_by": "hermes"
+}
+```
+
+补充约束：
+
+- `rule_markdown_draft` 不能是任意自由文本，必须符合固定模板。
+- 规则候选应同时携带机器可读 JSON 草稿，例如 `runtime_rule`。
+- JSON 草稿只能从受控模板族中选择，不允许 Hermes 自创字段结构后直接进入规则中心。
+
+## 4. 规则 Markdown 推荐结构
+
+```markdown
+# 规则名称
+
+## 目标
+
+## 适用范围
+
+## 输入字段
+
+## 判断规则
+
+## 输出
+
+## 测试样例
+
+## 管理员备注
+```
+
+推荐再补一段模板元信息：
+
+```markdown
+## 模板信息
+
+- 模板键：`travel_standard_v1`
+- 来源文档：公司支出管理办法（2024）
+- Hermes 置信度：0.86
+- 审核人：张三
+```
+
+## 4.1 规则 JSON 推荐结构
+
+规则中心不应只有 Markdown。
+
+应同时提供可执行 JSON 编辑区，至少支持：
+
+```json
+{
+  "kind": "policy_rule_draft",
+  "version": 1,
+  "template_key": "travel_standard_v1",
+  "rule_name": "差旅住宿标准草稿规则",
+  "scenario": "travel_reimbursement",
+  "review_required": true,
+  "conditions": {},
+  "actions": {},
+  "source_document_name": "公司支出管理办法（2024）"
+}
+```
+
+治理要求：
+
+- Markdown 负责给人看。
+- JSON 负责给运行时和规则引擎看。
+- 两者必须成对维护，不能只改其中一份。
+- JSON 变更也必须走版本和审核。
+
+## 4.2 模板族约束
+
+Hermes 只能从白名单模板中选，不允许自由生成任意规则结构。
+
+第一版建议模板：
+
+```text
+travel_standard_v1
+expense_amount_limit_v1
+attachment_requirement_v1
+general_policy_v1
+```
+
+如果制度条款不适合自动规则化：
+
+- 允许只生成 `knowledge_candidate`
+- 或只生成 `general_policy_v1` 草稿并要求人工补齐
+- 不能为了“有结果”而编造可执行规则
+
+## 5. 审核要求
+
+规则上线必须满足：
+
+- 有审核人。
+- 有版本。
+- 有测试样例。
+- 有来源依据。
+- 有回滚方案。
+
+补充：
+
+- Hermes 生成规则默认只能是 `draft`。
+- Hermes 不能直接覆盖当前 `active` 线上规则。
+- Hermes 如发现制度更新，应优先生成新的候选或草稿版本，仍需人工审核后再上线。
+
+## 6. 规则执行反馈
+
+每次规则运行应记录：
+
+```text
+rule_id
+rule_version
+input_snapshot
+hit_result
+risk_level
+operator_feedback
+false_positive
+false_negative
+```
+
+## 7. 规则优化来源
+
+```text
+误报反馈
+漏报反馈
+审批人修改意见
+Hermes 每日复盘
+制度文档更新
+MCP 新字段可用
+```
+
+## 8. 开发阶段建议
+
+```text
+Step 1: 规则 .md 编辑和版本
+Step 2: 规则审核上线
+Step 3: 规则运行日志
+Step 4: 人工反馈误报/漏报
+Step 5: Hermes 生成规则候选
+Step 6: 规则候选审核
+Step 7: 规则测试样例管理
+Step 8: 规则质量看板
+```