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 文档。

存储与路径契约

Installs
20
First Seen
Apr 29, 2026
issue-troubleshooting — anian0/pick-skills