Skills（Claude Code 技能系统）
Skills 是 [[Claude Code]] 的"插件生态"，支持渐进式功能揭示（Progressive Disclosure）。它们是可复用的功能模块，只在需要时才向 Claude 暴露特定功能或上下文，避免信息过载。
核心特性
- 文件夹结构：Skill 是文件夹而非文件，包含 references/、scripts/、examples/ 等子目录。
- Gotchas 章节：每个 Skill 建 Gotchas 章节，记录历史失败点，让 Skill 越用越聪明。
- description 字段是触发器：写"何时触发"而非摘要，决定 Skill 何时被调用。
context: fork：在隔离子代理运行 Skill，主上下文只见最终结果。- 嵌入脚本/库：让 Claude 组合而非重构 boilerplate。
!command注入动态 shell 输出：Claude 运行后仅见结果。
设计原则
- 不要写显而易见内容：只记录 Claude 不知道或容易出错的信息。
- 不要 railroading（强行步骤）：给目标与约束即可，让 Claude 自主决定实现方式。
- 自进化机制：Gotchas 部分让 Skill 越用越聪明，每次失败都记录经验。
使用场景
- 特定框架或库的使用指南
- 项目特有的构建和部署流程
- 测试和调试的最佳实践
- 代码审查和质量检查
相关概念
- [[commands-claude-code]] — 快捷指令系统，与 Skills 互补
- [[hooks-claude-code]] — 自动化钩子系统
- [[agentic-engineering]] — 结构化 AI 编程方法论
- [[上下文预算]] — 上下文管理艺术
- [[ai-skill]] — 可复用的工作流和最佳实践包