用途：用于调试失败、异常行为、崩溃或慢路径，尤其是难以定位的 Bug 与性能回归。它把诊断拆成六个阶段，并允许在任意阶段被 Bug 打断后返回原阶段。
主要能力与流程：阶段一建立反馈回路，优先创建快速、确定、可由智能体运行的通过/失败信号，例如失败测试、CLI fixture、HTTP 脚本、浏览器脚本、重放 trace、一次性 harness、property loop、二分或差分回路；若无法建立回路则停止，说明尝试内容并请求访问权限、捕获产物或插桩许可。阶段二运行回路直到复现用户描述的失败，记录确切症状并使其可重复。阶段三提出 3–5 个可证伪的排序假设，每个假设须预测何种观察或改动能证明其错误。阶段四一次只探测一个变量，优先调试器/REPL，其次定向日志，临时日志用 [DEBUG-...] 标记并在之后移除。阶段五把最小化复现转为正确接缝处的失败测试，修复后重跑原回路；若不存在正确接缝，记录该发现。阶段六移除调试代码与一次性 harness，说明胜出假设及可预防该 Bug 的措施。
使用方式：相对文件引用通常从 skill_dir 解析；git status、bun test 等普通工作区命令默认在工作区运行；显式引用打包技能文件用 $PI_SKILL_DIR/path，显式引用工作区/项目文件用 $PI_WORKSPACE/path。通过 KNOWLEDGE_VAULT_ROOT 或 wiki config --effective --repo <path> 解析 vault；除非代码仓库本身即配置的 vault，否则不要在其中创建持久项目记忆 markdown。Forge 跟踪使用时遵守当前 Forge 阶段包、所需技能、产物归属与允许写入；独立使用时持久记忆经 Wiki 写入 ${KNOWLEDGE_VAULT_ROOT}/projects/<project>/。诊断完成后返回被中断阶段；若修复变成非平凡实现工作，创建或继续 Forge slice，并通过当前 Forge 阶段包记录 TDD/验证证据。
限制：资料未提供具体安装命令、收费方式、支持平台或效果数据；无法建立反馈回路时应停止并请求必要访问或产物，不应在缺少可复现信号时继续假设。