Skills: 常见问题与排错

问题诊断四层
├── 第一层：文件层
│   ├── 文件是否存在？
│   ├── 路径是否正确？
│   └── Frontmatter 是否有效？
├── 第二层：配置层
│   ├── 触发器是否匹配？
│   ├── 工具是否绑定？
│   └── 权限是否足够？
├── 第三层：提示词层
│   ├── 指令是否清晰？
│   ├── 示例是否充分？
│   └── 约束是否明确？
└── 第四层：执行层
    ├── 工具是否按预期调用？
    ├── 输出是否符合格式？
    └── 结果是否达到目标？

提示词 A/B 测试
1. 保持其他条件不变
2. 只修改一处提示词
3. 对比输出质量
4. 保留更好的版本
5. 记录变更原因

问题复现步骤
1. 创建最小化的 Skill 文件
2. 只保留核心提示词
3. 确认问题是否复现
4. 逐步添加内容，定位触发条件
5. 针对性修复

常见微调技巧
├── 加示例：输出格式不对 → 添加期望输出示例
├── 加约束：输出太啰嗦 → 添加"简洁，不超过 N 行"
├── 加步骤：工具不调用 → 添加"第 N 步：使用 XX 工具"
├── 加条件：行为不正确 → 添加"如果 X，则 Y；否则 Z"
└── 加否定：做了不该做的事 → 添加"不要做 X"

工具问题修复
├── 工具不调用：在流程中明确指定"使用 Read 读取文件"
├── 用错工具：在提示词中说明"用 Edit 而非 Write 修改文件"
├── 权限不足：检查 settings.json 中的 allow/deny 配置
└── 工具超时：缩小搜索范围，减少数据量

触发器问题修复
├── 不触发：关键词太冷门 → 添加常用同义词
├── 误触发：关键词太宽泛 → 缩小匹配范围
├── 冲突：多个 Skill 竞争 → 调整优先级
└── 频繁触发：条件太宽松 → 添加 AND 条件

## 调试检查清单

### 基础检查
- [ ] 文件路径正确
- [ ] Frontmatter YAML 语法正确
- [ ] name 和 description 已填写
- [ ] triggers 已配置

### 功能检查
- [ ] 工具绑定完整
- [ ] 提示词有明确的执行步骤
- [ ] 有输出格式示例
- [ ] 有约束和边界条件

### 质量检查
- [ ] 在测试项目上验证过
- [ ] 输出格式稳定
- [ ] 工具调用合理
- [ ] 无安全风险