issue-troubleshooting
Installation
SKILL.md
问题排查与修复
这是一个流程型 skill。核心原则:先找到根因,再动手修复;没有根因调查,就不允许提出修复方案。
触发与边界
触发:测试失败、生产 bug、异常行为、性能问题、构建失败、集成问题、主流程与预期不一致、同一问题多次修复未生效、用户要求"看看报错/问题/功能不对"。
不触发:用户只要求设计新功能、规划正常需求开发、编写需求文档、做纯代码审查且没有明确故障现象。此类任务应使用更匹配的 skill;如果排查中发现根因其实是需求或架构方案缺失,本 skill 只记录排查结论,不代写需求或技术方案。
与其他 skill 的关系:
- 修复被判定为大修时,调用
implementation-planning,见其 SKILL.md;若该 skill 不可用,则把本 skill 产出的修复方案概要作为人工确认清单,不直接实施大修。 - 大修计划确认后,调用
plan-execution,见其 SKILL.md;若该 skill 不可用,则停止在已确认计划处,向用户说明无法继续按计划执行。 - 项目已有技术方案时只读引用项目内的
workplace/<version>/tech-design/内容;不得因为 bug 修复而创建新的 tech-design 文档。