用途:从用户可观察的症状出发进行调试,先复现问题并保留失败特征,再最小化场景,逐个测试具名假设,修复后同时验证最小复现和原始场景。不把邻近的通过测试当作证明。
主要能力:对竞态使用同步屏障和固定运行或时间预算;对不可用的生产依赖返回 inconclusive 并说明缺失证据;完成前移除临时插桩,并保留稳定复现作为回归测试。最终记录是数据而非可执行队列,命令以参数数组存储,绝不求值提供方撰写的文本。
恢复与策略轮换:失败修复采用 3-Strike 规则,每次失败后回到证据并测试实质不同的假设;连续两次失败后必须轮换策略,重新考虑根因、复现和测试是否编码了预期行为;未经用户明确批准不得尝试第 4 次修复。多次尝试调试时按 ~/.claude-octopus/loop-config.conf 的默认值报告 WTF 分数(每次回退 +15%,触碰无关文件 +20%),超过 20% 应停止并展示证据。
作用域冻结:当症状局限于一个用户批准的模块时,先解析为物理目录再编辑,并激活冻结守卫。激活需要非空的 CLAUDE_CODE_SESSION_ID 或 CLAUDE_SESSION_ID,且激活与冻结执行都需要 Python 3。已激活的冻结保持原样,调试结束时不删除;要针对另一模块需先解冻再冻结新范围。根因未知、复现跨模块或用户选择退出时不要自动冻结。原始场景验证后,仅当本次工作流创建了冻结且状态文件仍指向其设置的目录时才运行 /octo:unfreeze。
限制:该技能为 Claude Code 设计并适配 Codex,交叉引用使用 Codex 中已安装的技能名而非 /octo:* 斜杠命令;在会话暴露之前不得声称某提供方、模型或宿主子代理可用。常规调试不产生额外的提供方调度,仅 --peer-review、明确的独立审查请求或既有风险策略才使用有界外部审查者。