用途:以证据优先的方式调查缺陷,产出报告与补丁提议,代理不得应用代码改动。输出仅限调试报告、证据摘要、复现说明、排序假设、插桩建议、可选回归测试提议与补丁提议。
主要能力与约定:生成物只写入 .lcs/work-items/{timestamp}-{slug-work-item}-debug-ext/,结束时该目录下的 debug.md 必须存在。不得写入 .lcs/debug/、.aix/、docs/、项目根、源文件、测试文件、指令文件或技能文件,除非用户在单独的后续任务中明确要求。不修改源码、测试、配置、文档或指令。报告中注明 Changes applied: None,区分已确认事实与假设、补丁提议与已应用改动;证据缺失处用 [TODO],需澄清或用户决策处用 [ASK USER]。遵循 ../lcs-shared/contract.md 与 ../AGENTS.md 的共享文件夹命名规则,工作项目录以 -debug-ext 结尾。报告结尾须附规范 Handoff 页脚。
使用方式(工作流):阶段1收集上下文并创建输出目录,slug 用小写 a-z0-9-;阶段2优先建立快速可重复的反馈回路(已有失败测试、小型测试命令、带夹具输入的 CLI、本地或开发服务器 HTTP 请求、最小脚本、手工复现清单、人机回路笔记);阶段3复现或表征失败,记录复现状态(已复现/部分复现/未复现/仅证据)、命令、预期与实际、置信度;阶段4生成3-5个可排序、可证伪假设,含支持与反证证据及预测观察;阶段5为每个主要假设提出一个定向检查,一次只改一个变量,临时调试日志须用唯一前缀(如 [DEBUG-lcs-7f3a])并附清理命令;阶段6给出补丁提议与回归测试选项(不应用);阶段7按 references/report-template.md 生成 debug.md;阶段8清理与事后复盘。
适用场景:非确定性缺陷可先做3-5次轻量运行并记录复现置信度,重压测试仅作可选后续。若缺陷涉及更广的设计或架构问题,建议转交后续技能而非在此技能内解决。限制:无可用反馈回路时不得声称有进展,应记录缺失并索取最小有用工件(日志、堆栈、失败命令、输入样本、HAR、录屏或环境访问);证据不足时仍产出报告,但以 [TODO] 与 [ASK USER] 明确标注。