agent-planner

需求路由

def route_demand(demand: str) -> str:
    d = demand.lower()
    if any(kw in d for kw in ["派生子代理", "spawn", "执行审查"]): return "local"
    if any(kw in d for kw in ["规划", "方案设计", "帮我生成"]): return "llm"
    if any(kw in d for kw in ["坑点", "风险"]): return "hybrid"
    if any(kw in d for kw in ["检索", "知识库"]): return "hybrid"
    return "llm"

执行流程

F0 — 调查（强制入口）

任何规划任务必须先完成调查，产出调查摘要，再进入 F1。

调查维度：事实 / 范围 / 深度 / 依赖 / 风险 / 资源

调查摘要格式：

## 调查摘要
- 事实：{现有条件概述}
- 范围：{规划边界}
- 复杂度：{简单/中等/复杂 + 依据}
- 主要依赖：{依赖项}
- 风险点：{风险}
- 资源约束：{时间/Token/预算}

F0.5 — 事实验证（强制）

调查摘要产出后、进入 F1 前，必须对关键数字声明执行现场验证。

验证维度：文件行数 / 文件大小 / 路径存在性 / API 签名 / 版本号 / 文件数量

from fact_check import verify_source_claims
verifications = verify_source_claims(source_claims, base_dir=".")

结果判定：

验证结果写入调查摘要的 verification_results 字段。

F1 — 前置验证

• rules.md + identity-config.md 存在 → 否：阻塞
• 核心 skill 已安装 → 否：降级到通用能力
• 变更目标可确认 → 否：追问确认

F2 — 用户确认

• 规划方案输出后等待用户确认
• 修改型变更（≥P1）需显式确认

F3 — 成本预估

F4-F12 — 详细规划流程

详细流程（F4 架构方案 → F12 残余 Cron 生成）见 references/workflow.md。

阶段A — 审计（强制）

规划方案完成后、用户确认前必须执行审计。见 references/audit-protocol.md。

知识库检索

规划涉及特定领域时检索知识库。详见 _knowledge/_enhancement/knowledge-base-integration.md。

质量自检

综合≥3.5 → 通过；<3.0 → 需改进

版本迭代

• 迭代上限 5 版，超限强制用户决策
• 版本号格式：v{主}.{次}
• 每版记录变更摘要到 _knowledge/_enhancement/plan-tracker/evolution-log.md

分级加载索引

自学习 & 事实核查

事实核查：每次执行完成、返回结果前，必须调用 _shared/fact-checker/fact_check.py。 详见 references/self-learning.md。

参考文件

故障与降级