spec-debug

系统化复现、定位根因并修复 bug 或失败。

ASCII 链路图

Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
  |
  v
  spec-debug
  entry: spec-debug
  type: workflow command

基本信息

字段	内容
Skill	spec-debug
类型	workflow command
研发链路位置	Code
当前入口	spec-debug
兼容别名	/spec:debug、$spec-debug
Source	skills/spec-debug/SKILL.md
Governance	src/cli/contracts/dual-host-governance/skills-governance.json（supported-host skills governance）

描述

Diagnosis loop for bugs and failing behavior. Use for errors, stack traces, regressions, failed tests, issue-tracker bugs, stuck investigations after failed fixes, or asks to debug/fix a bug.

Source 契约摘要

该 source skill 未声明标准 Workflow Contract Summary 小节；本页以 frontmatter、supported-host governance 和维护者补充元数据为准。

何时使用

• 有 stack trace、测试失败、异常行为或 bug report。
• 已有修复尝试失败，需要回到根因。
• 需要通过复现和验证证明修复。

工作步骤

• 读取 plan、task pack、bug report 或明确实现目标。
• 建立小步任务列表，按现有代码模式做最小必要修改。
• 运行聚焦验证、测试、构建、浏览器或平台检查。
• 把 diff、验证结果和剩余风险交给 review 或 knowledge 阶段。

输出

• 实现 diff、测试结果、构建输出、浏览器截图或运行证据。
• 必要时输出 blocked 原因，而不是扩大 scope。

Agent 调度

• 小任务通常 inline；大任务可按文件边界使用 serial 或 parallel workers。
• 调试、优化、UI、平台专项可引入对应 specialist agents，但 orchestrator 负责最终集成。

本 skill 当前没有 skill-local references/agents 或 references/personas 文件；默认由 orchestrator 直接完成，或按阶段需要临时调用其他 skill 的专家。

边界

• 不把 bug 当新 feature 规划。
• 不能绕过复现和回归验证。

源码校准

• 本页由 website/scripts/generate-skill-detail-pages.js 从上游 source skill 生成。
• 当前入口、兼容别名与宿主投递 metadata 来自 src/cli/contracts/dual-host-governance/skills-governance.json。
• 当 source skill 或 governance contract 变化后，应重新运行 npm run reference:pages 并执行 npm run content:audit。