SuperAPI AI 工具集

ac-debug

编程与开发

查看项目

更新于 10-16 09:27

技能介绍

用途:定位报错与异常的根因。由 Claude 主线程统筹诊断,必要时并行启动 subagents 取证;最终诊断、用户沟通、代码修复与验证均由主线程完成。

主要能力与角色分工:主线程负责收集问题、决定是否启用 subagents、整合证据、输出诊断、等待确认并执行修复;subagents 并行检索调用链、日志线索、配置与测试影响等证据,不修改代码。

使用方式:/ac-debug <问题描述>。执行工作流分为:阶段 0 Prompt 增强(可选,补全目标、技术约束、范围边界、验收标准);阶段 1 上下文收集与并行取证,主线程先收集错误日志、堆栈、复现步骤和相关文件,跨模块或线索多时按需启动 subagents,典型拆分为调用链排查、证据收集、影响面排查;阶段 2 主线程诊断,按可能性排序输出假设,每条含原因、证据、验证方式、修复建议;阶段 3 假设整合,交叉验证并筛选 Top 1-2 原因;阶段 4 用户确认(Hard Stop),必须等待用户确认后才能进入阶段 5;阶段 5 由主线程实施修复,运行最小相关范围测试或验证。

工作目录约束:若通过 /add-dir 添加了多个工作区,先用 Glob/Grep 确定相关的工作区;无法确定时用 AskUserQuestion 询问用户。诊断与修复在会话内完成,不依赖外部模型或额外会话。

subagents 使用条件:适用错误路径不清、涉及多个模块、日志或堆栈很多、需并行排查多个方向的场景;优先使用只读 subagents 做调用链检索、错误点上下文收集、配置与测试影响分析;不适用于报错点明确、单文件小问题、两三次检索即可收敛的简单问题。

限制与关键规则:不调用外部模型、后台任务或额外 Bash 编排;subagents 只做检索与取证,不修改代码,不直接给用户下最终结论;已委托给 subagents 的搜索或分析内容主线程不重复执行;最终诊断结论必须由主线程统一输出;修复前必须展示诊断结果并等待用户确认;证据以代码、日志、堆栈与复现信息为准。费用、价格与平台信息暂未提供。