用途:处理用户提出的调试请求,如 debug、修复 bug、调查错误、追踪根因、定位 bug 等。
主要能力与机制:采用串行、每轮一个全新子智能体的假设循环,每个子智能体基于全新上下文调查;主对话作为“薄编排器”,只负责初始化 .planning/HYPOTHESES.md、派生子智能体、评估进展、以及在子智能体声称修复时亲自运行回归测试。声称修复需经过两道结构门:必须先写出并确认失败的新回归测试,再实现最小修复使其通过,主对话独立运行该测试。进展以文件(HYPOTHESES.md、LEARNINGS.md)持久保存,而非对话历史。设置最多 10 轮无解后升级给用户,并在上下文剩余过低时写入状态并调用 dev-handoff。
使用方式:技能启动时先加载约束(命令见原文:!uv run python3 ${CLAUDE_SKILL_DIR}/../../scripts/load-constraints.py dev-debug),随后创建或更新 .planning/HYPOTHESES.md,再派生出第一个调查子智能体。在派生子智能体前主对话禁止读项目代码、编辑、运行项目命令、grep 或形成假设(原文称“认知锁”)。进入循环后检查 HANDOFF.md 以支持跨会话恢复;用户发来与当前 bug 无关的消息时需先声明暂停循环,处理后再声明恢复并读取状态继续。
适用场景:需要系统性、可追溯根因的调试任务,包括代码、服务与 GUI 应用调试(GUI 需完成 BUILD、LAUNCH、WAIT、CHECK PROCESS、READ LOGS、VERIFY 等执行门)。
限制与要求:主对话不得触碰代码库,只可运行回归测试这一条项目 Bash 命令;读日志、docker exec、curl、数据库查询、读源码均属调查,必须交给子智能体。每轮仅测试一个假设,不得重复已 REFUTED 的假设;不得声称“已找到根因”除非有可复现的回归测试且修复使其通过并能解释机制。原文未提供价格、收费或平台支持范围等信息。