Skills 不触发的诊断与修复
阅读提示：90% 的 Skills 问题都是 description 写得太模糊。本文基于 650 次自动化测试和社区经验总结。
7.1 核心洞察
一句话总结：description 的写法有 20 倍 的影响。
| description 风格 | 激活率 | 示例 |
|---|---|---|
| 被动式 (A) | 37% | "Use when..." |
| 扩展式 (B) | 85% | "...or any X-related" |
| 指令式 (C) | 100% | "ALWAYS invoke...Do not X directly" |
7.2 症状识别
问题类型
| 症状 | 表现 | 常见原因 |
|---|---|---|
| 完全不触发 | Claude 完全忽略 Skill | description 太模糊 |
| 过度触发 | 不相关时也激活 | description 太宽泛 |
| 错误触发 | 激活了错误的 Skill | 多个 Skill description 重叠 |
| 偶尔触发 | 不稳定，时好时坏 | 上下文预算或随机性 |
快速自检
# 在 Claude Code 中运行
> What skills are available?
预期结果：你的 Skill 应该出现在列表中。
异常情况：
- Skill 不在列表 → 文件位置或语法错误
- 显示 "excluded from context" → 上下文预算超限
7.3 诊断流程
Step 1：/context 检查
> /context
AI 编程知识库会员专享内容
开通后解锁「Skills 不触发的诊断与修复」全文，AI 编程知识库全年访问
扫码添加企业微信，找大熊掌门开通会员
添加后说明想开通的会员类型即可