用途
该技能为智能体提供一套用于诊断复杂缺陷和性能回归的纪律性流程。当用户请求"诊断"、"调试这个",或报告某功能损坏、抛出异常、失败、变慢时,可调用此技能。核心主张是:解决困难缺陷的关键在于先构建出能够稳定触发该缺陷的快速反馈循环,而非直接阅读代码猜测原因。
主要能力
- 七阶段诊断流程:阶段1构建反馈循环;阶段2复现并最小化;阶段3提出3–5个可证伪的排序假设;阶段4针对每个假设进行定向探测;阶段5修复并编写回归测试;阶段6清理调试痕迹。
- 反馈循环构建方式:按推荐顺序给出了失败测试(单元/集成/e2e)、Curl/HTTP 脚本、CLI 调用与快照对比、无头浏览器脚本(Playwright/Puppeteer)、重放捕获的 trace、一次性最小化测试环境、属性/模糊测试循环、二分查找测试、差分循环、人工介入脚本等多种构建方式。
- 非确定性缺陷处理:目标不是干净复现,而是提高复现率;通过循环100次、并行化、加压、缩小时间窗口、注入延迟等方式将50%复现率的缺陷提升至可调试水平。
- 性能回归分支:使用基线测量(计时工具、performance.now()、分析器、查询计划)后再二分定位,强调先测量后修复。
- 回归测试与清理:要求在正确的接缝处先写失败测试再修复;如无正确接缝,需记录该事实并标记为架构问题。完成后需确认原始复现场景不再复现、回归测试通过、所有带
[DEBUG-...]前缀的调试日志已删除、一次性原型已清理。 - 安全与脱敏:要求对命令输出和捕获物中的密钥进行脱敏,用
<REDACTED>替代,通过环境变量传递凭据,仅引用包含信号的行。 - 依赖技能集成:调用
/domain-modeling读取项目配置的工件与术语,仅在任务授权编辑时通过该所有者持久化模型变更;委派工作时使用/swarm,采用宿主实际 schema、隔离写入器并披露回退方案。
使用方式
作为智能体技能被调用,按阶段执行。阶段1的完成标准是:存在一条已至少运行过一次、会因该缺陷而变红(失败)的命令,且该命令具备红敏性(能捕获用户描述的具体症状)、确定性(每次运行结果一致)、快速性(秒级而非分钟级)、可由智能体无人值守运行。若无红敏命令,不得进入阶段2。阶段3的假设需在测试前展示给用户,以便利用领域知识快速重新排序。阶段4要求每次只改变一个变量,优先使用调试器/REPL 检查,其次是在区分假设的边界处打定向日志,并给所有调试日志加唯一前缀。
适用场景
适用于难以定位的复杂缺陷、偶发失败、性能回归等需要系统性诊断的工程问题。
限制
当确实无法构建反馈循环时,技能要求明确停止并列出已尝试的方法,向用户请求以下之一:可复现问题的环境访问权限、脱敏后的捕获工件(HAR 文件、日志转储、核心转储、带时间戳的屏幕录制),或添加临时生产环境埋点的许可。在没有循环的情况下不得进入假设阶段。