核心用法
Fix是一个行为纠正技能,当用户使用fix:前缀(如"fix: why didn't you commit?")或类似反馈触发。其核心流程为:
1. TodoWrite先行 — 激活后立即注册4项TODO,禁止先输出文本
2. 5-Why根因分析 — 至少深挖3层:症状(Why 1) → 判断失误(Why 2) → 结构性缺陷(Why 3)
3. 优先级修复 — 按Skill → Rule → Hook → 文档的顺序定位并修复根因
4. 立即修复当前问题 — 验证后继续原任务,而非仅清理错误产物
5. 完成报告+清理TODO — 会话级TODO必须删除,不得持久化
显著优点
- 系统性防复发:不仅修症状,更通过改进skills/rules/hooks防止同类问题重现
- 强制结构化:TodoWrite前置、优先级明确的修复流程,避免随意补丁
- 深度归因:5-Why方法避免"头痛医头",直击知识/规则缺口
- 无缝恢复:修复后继续原任务,不打断用户工作流
潜在局限
- 依赖用户触发模式:需用户主动使用
fix:前缀或特定关键词 - 根因分析深度依赖:若AI推理不足,Why 2-3层可能流于表面
- 文件定位开销:需搜索skills/rules/hooks,复杂项目可能耗时
- Skill优先可能过度设计:小问题也可能触发skill修改,需权衡成本
适合人群
- 高频使用Claude Code的长期项目开发者
- 追求"教AI一次,永久受益"的重度自动化用户
- 有完善skills/rules体系、持续迭代理性习惯的技术团队
常规风险
- TODO未清理:违反"会话级临时性"原则,污染任务列表
- 跳过Skill直接记failed-attempts.md:错失结构性修复机会
- Why 1即停:仅修当前症状,问题换形式复发
- 过度自信执行:不确定命令时未AskUserQuestion,可能误操作
安全认证
报告为系统占位生成,未执行实际安全扫描。