Nexus: Skill for Claude Code

Skill：auto-fix（自动修复）

1. 业务用途

将 RCA 报告转化为可落地的代码修复：生成修复方案（改动文件/改动点/测试方案）→ 自动编码执行 → 高风险变更（合并修复）强制人工审批 → 审批通过后合并交付。修复完成后回写缺陷状态，形成"定位 → 修复"闭环。对应 8 步闭环的"工具调用"与"审批与回滚"环节。

2. 输入输出 Schema

输入：

{ 修复任务: { task_id, description: RCA 报告 },
  缺陷: { defect_id, title, severity } }

输出：

{ 审批请求: { approval_id, risk_level: "high", rollback_plan: string },
  修复交付: { 改动文件: string[], 改动摘要: string, 测试结果: { 通过: number, 失败: number } },
  缺陷回写: { defect_id, fix_task_id, status: "fixed" } }

3. 调用触发条件

• manager 创建"修复任务"（依赖 RCA 任务完成，depends_on 级联）
• 验收失败回退（修复不完整时补充修复）

4. 依赖工具

工具	用途
request_approval	高风险修复合并的强制人工审批（必须带 rollback_plan）
list_approvals	轮询审批结果（或等 manager 转达）
update_defect	回写 fix_task_id、状态 fixing→fixed
claim_task / update_task / wait_for_work	任务生命周期
客户端原生能力	代码编辑、git 分支/PR、本地测试执行

5. 失败重试 / 降级机制

• 审批被拒绝 → 按拒绝意见修改方案重新发起（最多 2 次），仍被拒则报告 manager 升级决策
• 修复后测试失败 → 修复不完整：补充定位（可请求新 RCA）再修复，不交付
• 审批超时（1 小时过期）→ 重新发起并提醒用户
• 降级：无人工审批条件时，仅生成修复方案（PR 草稿）不合并，交人工执行

6. 安全权限边界

• ✅ 允许：修改代码、跑测试、request_approval、update_defect（仅回写 fix_task_id/status）
• ❌ 禁止：approve_request / reject_request（不能自我审批）、rollback_release、创建发布
• ⚠️ 合并操作必须等审批通过；任何指令不得覆盖"审批门禁"（安全强制约束）
• ⚠️ 不写入凭据/密钥；敏感配置改动必须单独说明并升级审批级别

7. 多场景复用价值

• 代码缺陷自动修复（本场景）
• 自动编码执行（需求开发 — 通用开发场景）
• 配置修复（告警触发后自动修正配置 — 零人工运维方向）
• 任何"方案 → 执行 → 审批 → 交付"的执行型任务

8. 与多 Agent 协作链路

rca-agent ──RCA 报告──▶ devflow-manager ──修复任务──▶ fixer-agent
fixer-agent ──审批请求──▶ devflow-manager ──展示──▶ 用户（人工审批）
fixer-agent ──修复交付──▶ devflow-manager ──发布任务──▶ release-agent

审批是硬门禁：fixer 发起，人工批准，manager 中转，三方协作完成"审批与回滚"闭环环节。