在 Claude Code 中，Skill 是一种轻量级、单一职责的模块化功能单元，可以将重复的、结构化的开发指令封装成可复用的自动化 AI 工作流，从而显著提升开发效率和一致性 [ref_2]。Skill 能够支撑主 AI 与 Sub Agent 的自动化调用 [ref_2]，并且可以与 CLI 工具深度集成 [ref_1]。

Skill 的使用主要分为安装、配置和应用三个核心环节。不同方案在操作方式和适用场景上存在差异。

一、Skill 的核心配置文件：SKILL.md

所有 Skill 都必须通过一个结构化的 SKILL.md 文件来定义。这个文件分为两部分：YAML 格式的元数据头（Front Matter）和 Markdown 格式的主体内容 [ref_1][ref_6]。

以下是一个标准的 SKILL.md 文件示例，用于创建一个“代码解释”技能 [ref_1]：

--- skill_name: explain_code triggers: - explain this code - what does this code do - 解释这段代码 description: 这是一个代码解释技能。当用户提供一段代码时，我会分析其功能、逻辑结构、关键变量和方法，并以清晰易懂的语言解释其工作原理和潜在用途。 version: 1.0.0 author: your_name visibility: project # 或 user, public --- # 代码解释技能 指令 作为代码解释专家，你的任务是深入分析用户提供的任何代码片段。请按照以下结构进行解释： 1. 整体功能: 用一两句话总结这段代码的主要目的。 2. 逐行/逐块分析: 分解代码的关键部分，解释每个函数、循环、条件判断的作用。 3. 输入与输出: 说明代码期望的输入和最终产生的输出。 4. 关键算法/逻辑: 如果涉及复杂逻辑或算法，进行简要说明。 5. 潜在问题或改进: 指出代码中可能存在的边界情况、错误或性能瓶颈，并给出改进建议。 请保持解释的通俗易懂，即使对于编程新手也足够友好。 

关键元数据字段说明 [ref_2][ref_6]：

• skill_name: 技能的唯一标识符。
• triggers: 触发此技能的短语列表。AI 会根据用户问题是否包含这些短语来决定是否自动调用该技能 [ref_3]。
• description: 至关重要的描述字段。AI 不仅用其向用户介绍技能，更用它来判断在何种上下文下自动触发该技能。描述应清晰、具体，最好包含使用场景和关键词 [ref_2][ref_6]。
• visibility: 控制技能的可见范围，project 仅当前项目可见，user 对用户所有项目可见，public 可发布到市场 [ref_6]。

二、Skill 的安装与作用域管理

安装后的技能默认仅在当前项目（project scope）中可用 [ref_5]。如果你希望一个技能在所有项目都能使用，需要进行作用域管理。

1. 使用 CC Switch 工具（推荐）[ref_5]: 这是一个专为管理 Claude Code 技能作用域设计的 CLI 工具。安装后，可以便捷地将技能切换为全局模式。

   # 假设已安装 CC Switch cc-switch enable --skill explain_code --scope user 

2. 手动修改配置文件 [ref_5]: 在 Claude Code 的配置文件（通常位于 ~/.config/claude/ 或 VS Code 设置中）里，找到相关设置，将技能的 scope 或全局的 skill_scope 修改为 user。
3. 在每个项目中重复安装: 最直接但效率最低的方法，即在每个新项目的 .claude/skills/ 目录下都放置一遍技能文件。

三、Skill 的调用方式与实战应用

技能可以通过多种方式被激活，以下是几种典型场景。

场景1：显式调用 PR 描述生成技能 在开发中，我们经常需要为 Pull Request 编写描述。可以创建一个技能来自动化此流程 [ref_2]。

# .claude/skills/generate_pr_description.md 的部分内容 --- skill_name: generate_pr_description triggers: - write pr description - generate pr summary - 写PR描述 description: 根据提供的代码变更（diff）和可选的上下文，自动生成结构清晰、内容完整的 Pull Request 描述。描述应包括变更目的、主要修改内容、测试情况和相关issue链接。 --- 

应用时，在 Claude Code 对话框中输入：@generate_pr_description，然后粘贴你的 git diff 输出，AI 就会按照技能定义的模板生成专业的 PR 描述 [ref_2]。

场景2：自动触发数据库查询技能 对于数据相关项目，可以创建一个技能，当 AI 识别到用户想查询数据时自动运行 [ref_3][ref_6]。

--- skill_name: query_database triggers: [] # 留空或设置通用触发词 description: 此技能用于根据用户需求构造安全的 SQL 查询语句，或分析数据库模式。当用户的问题涉及“查询”、“数据”、“SELECT”、“数据库表”等关键词时适用。 visibility: user --- 

当用户提问“请帮我查一下上个月销量最高的产品”，由于问题中包含“查询”等关键词，AI 可能自动调用此技能，并引导用户提供表结构或生成相应的 SQL [ref_6]。

场景3：通过 Skill-Creator 插件快速生成技能 对于不熟悉 SKILL.md 语法的用户，可以使用 Skill-Creator 插件 [ref_4]。该插件能将你与 Claude 反复磨合后得出的高效对话（prompt）一键编译成标准的技能文件。

1. 在对话中，使用 @Skill-Creator 命令激活插件。
2. 按照插件指引，提供你的任务描述、示例对话或关键指令。
3. 插件会自动生成结构化的 SKILL.md 文件，你只需将其保存到正确的技能目录即可 [ref_4]。

四、高级功能与**实践

1. 多文件技能：复杂的技能可以将逻辑分散在多个文件中。在 SKILL.md 的同级目录放置其他 .md 文件，在主体内容中通过相对路径引用它们。Claude Code 会将这些文件一同加载，共同构成技能上下文 [ref_6]。
2. 技能钩子 (Hooks)：可以在 SKILL.md 中定义 before_skill 和 after_skill 钩子，用于在执行技能前后自动运行一些脚本或命令，例如准备环境或清理资源 [ref_6]。
3. 调试与排查：
   • 技能未触发：检查 triggers 和 description 是否准确描述了使用场景。描述越精准，自动触发的匹配度越高 [ref_6]。
   • 技能冲突：如果两个技能的 triggers 或 description 过于相似，可能导致意外行为。建议为技能设置独特、具体的触发词和描述 [ref_6]。
   • 查看已加载技能：在 Claude Code 中，可以通过输入特定命令（如 /skills list，取决于版本）来查看当前会话中所有可用的技能。

总而言之，Claude Code Skill 的使用是一个从安装配置到灵活调用的完整流程。通过创建和利用 Skill，开发者能够将**实践和重复性工作固化为可共享的 AI 资产，是实现开发流程自动化与智能化的关键工具 [ref_1][ref_2]。