用途
self-healing-orchestrator 是一个供 AI 代理在执行过程中读取使用的参考技能,目标是处理已被分类为 F2(local-logic,本地逻辑)或 F3(local-design,本地设计)的失败:生成修复补丁的提案,交由用户决定是否应用。
核心原则
自愈只提议,用户才应用。提案与手动重规划走同一审批门槛,不存在自主打补丁的路径。资料明确指出:如果发现该技能未经用户同意就应用补丁,那是一个缺陷。
硬性约束(依据规范 §22.1)
- 仅限 F2(本地逻辑)或 F3(本地设计);若分类器返回 F1/F4/F5/F6,则拒绝,因为这些需要走不同路径。
- 只提议,绝不应用;输出始终是提案产物,用户通过 /aura-frog:heal accept <id> 才会应用。
- 置信度低于 0.7 不提案;只呈现原始发现,由用户判断是否可修复。
- 计入 replan_budget,与重规划器相同的节点级预算执行方式。
- 每个任务最多 1 次自愈;任务一旦接受自愈补丁,就不再自动提案。
- 会话上限:共 5 个提案;达到后转为手动 /aura-frog:plan-replan。
禁用机制(依据规范 §22.3、§31.3)
- 按会话禁用:/aura-frog:heal disable,写入 .claude/logs/.self-heal-disabled 标记。
- 永久禁用:在 .envrc 中设置 AF_SELF_HEAL_DISABLED=true。
- 禁用状态下,钩子集成会忽略任何提案。
工作流程(依据规范 §22.2)
- 检测到 F2 或 F3 失败,且预算仍有剩余时激活。
- 解析错误日志,提取错误类别、库与行号。
- 向 context7 查询已知库模式(不查随机网络来源)。
- 交叉参考 permanent_memory.md 中的“Gotchas discovered”记录。
- 生成草稿形式的补丁提案(diff 格式,不应用)。
- 评估置信度,低于 0.7 则拒绝提案。
- 主规划器向用户展示 diff、推理与置信度。
- 用户同意后,作为新的 T4 任务应用,走其自身审批流程。
- 用户拒绝后,记录 event: self_heal_declined 并增加会话计数。
来源白名单
允许来源:context7 MCP(库文档)、permanent_memory.md(项目自身经验)、近期轨迹 .claude/plans/traces/(同项目失败上下文)。禁止来源:Stack Overflow、博客文章、网页搜索结果,因其噪声大且易产生幻觉。
输出结构
提案产物包含:proposal_id、task_id、classification、confidence、reasoning、patch(文件、起止行、before/after)、acceptance_test、risks、budget_decrement、session_proposal_count。提案以 YAML 形式存放于 .claude/plans/proposals/HEAL-<TASK_ID>-<NNN>.yaml,直到被接受或拒绝。
反模式(均为硬性拒绝)
- 自动应用高置信度提案(置信度只是信号,用户批准不可协商)。
- 为 F4/F5 提案(作用域错误,应走重规划器)。
- 从随机网络搜索获取修复方案。
- 绕过预算。
- 置信度 ≥0.7 但证据不足;若无法引用至少 2 个有依据的来源,应将置信度降至 0.7 以下。
与其他组件的衔接
依赖 failure-classifier 提供 F2/F3 输入;master-planner 是提案的唯一消费者(向用户呈现);replanner 处理 F4/F5 的替代路径;共享 rules/workflow/replan-thresholds.md 的预算语义;应用已接受提案前,需按 checkpoint-discipline 做变更前快照;通过 /aura-frog:heal diagnose|status|disable|accept 命令操作;context7 MCP 是唯一外部知识来源(经 mcp-call-gate 限流)。
适用场景与限制
适用于采用分层规划、带失败分类与审批流程的 AI 编码代理工作流,尤其需要安全可控的自动修复建议时。限制:仅覆盖 F2/F3;必须有用户审批;受预算与会话上限约束;依赖 context7、永久记忆与轨迹等特定项目文件与命令体系;资料未提供其独立安装方式、价格或适用范围之外的平台信息。