Skills 进阶进阶
原题:Troubleshooting skills

排查 Skills 问题

当 Skill 没有按预期触发或输出不稳定时,系统定位说明、输入和文件结构问题。

官方内容翻译

排查 Skill 问题时,先把失败现象具体化:是没有触发、读错上下文、执行步骤偏离、脚本失败,还是产出不符合预期。

然后用最小输入复现问题,逐步缩小范围。不要一次修改太多内容,否则很难判断真正原因。

排障路径

  1. 1确认触发描述是否足够明确。
  2. 2检查说明文件是否存在冲突、遗漏或过度抽象。
  3. 3验证脚本、模板和资源文件是否能被正确读取。
  4. 4使用最小输入复现,再逐项扩展。
  5. 5把修复结果写回 Skill 的示例和注意事项。

官方 Starter Prompt 中文翻译

请帮我排查这个 Claude Code Skill 为什么没有按预期工作。请从触发条件、说明清晰度、文件结构、脚本执行和输出验收五个方面检查。