claude code skills

haorantianxia

Claude Code Skills 是‌可复用的标准操作流程（SOP）‌，通过 Markdown 文件定义，让 Claude 在特定场景下自动或手动执行标准化任务，提升协作效率与稳定性 。根据 Anthropic 官方文档，Skills 核心由 YAML 元数据与 Markdown 指令组成，支持全局或项目级配置 。‌‌‌

创建与文件结构

• ‌存储路径‌：
  • ‌个人全局‌：~/.claude/skills/<skill-name>/，适用于所有项目 。
  • ‌项目共享‌：.claude/skills/<skill-name>/，仅当前项目生效，可提交版本控制 。‌‌‌
    
• ‌核心文件‌：
  • 目录内需包含 SKILL.md，分为 ‌YAML 头信息‌ 与 ‌Markdown 正文‌ 两部分 。
  • 支持引用 references/、examples/ 等支持文件，实现渐进式加载以节省上下文 。‌‌‌
    
  
  

配置与调用机制

• ‌YAML 关键参数‌：
  • name：定义斜杠命令名（如 /commit）。
  • description：决定 Claude 何时自动加载，需包含具体场景关键词 。
  • allowed-tools：预设允许使用的工具（如 Read、Bash），无需每次授权 。
  • user-invocable：设为 false 可隐藏命令，仅允许自动触发 。‌‌‌
    
• ‌调用方式‌：
  • ‌手动‌：终端输入 / <name> 直接执行 。
  • ‌自动‌：当用户意图匹配 description 时，Claude 自动注入 Skill 上下文 。
  • ‌参数传递‌：通过 argument-hint 定义提示，Skill 内用 $ARGUMENTS 接收 。‌‌‌
    
  
  

最佳实践与示例

• ‌描述具体化‌：避免“帮我写代码”等模糊描述，应写明“当用户提到重构或优化时触发”。
• ‌官方示例‌：如 explain-code Skill，要求解释代码时包含类比、ASCII 图表及步骤 walkthrough。
• ‌复杂任务拆分‌：长指令拆分为支持文件，保持 SKILL.md 简洁（建议 500 行以内）。‌‌‌
•