阅读提示：本章节总结来自官方文档和社区的最佳实践，帮助你避免常见陷阱，构建生产级 Skill。

3.1 Skill 设计原则

原则一：单一职责

每个 Skill 应该专注于一个明确的领域。

✅ 好的设计：
├── api-documentation/    # API 文档生成
├── code-review/          # 代码审查
├── git-commit/           # 提交信息生成
└── test-generator/       # 测试生成

❌ 差的设计：
└── super-toolkit/        # 包含所有功能的"超级工具"
    └── SKILL.md (5000行，涵盖所有场景)

为什么：

• 单一职责让 description 更精确，触发更准确
• 降低 Token 消耗（不会加载不需要的指令）
• 更容易维护和测试

原则二：描述精确

description 是 Claude 决定是否激活 Skill 的唯一依据，必须精确。