快速摘要： Claude Code Skills 是模块化指令文件，通过教授 Claude 自定义工作流程、编码标准和领域特定任务来扩展其编码能力。Claude Code 的配置和自定义指令主要通过项目根目录下的 CLAUDE.md 文件或通过 Model Context Protocol (MCP) 服务器进行管理。

Claude Code 已不仅仅是另一个 AI 编码助手。根据官方文档，Claude 在涉及语言、推理、分析和编码的任务方面表现出色——但大多数开发者忽略了这一点：该平台通过 Skills 实现的可扩展性将其从一个有用的工具转变为一个个性化的开发强大引擎。

Skills 代表了 AI 助手工作方式的根本性转变。您只需编写一次偏好、编码标准或复杂工作流程，而无需反复解释。然后，Claude 会在出现相关上下文时自动应用这些知识。

时机再好不过了。开发社区已经创建了专门的 Skills，Anthropic 也在不断扩展 Skills 生态系统。但该功能仍未得到充分利用——社区讨论表明，相当一部分 Claude Code 用户可能不知道 Skills 的存在。

Claude Code Skills 是什么以及它们为何重要

Agent Skills 是打包成 Markdown 文件的模块化功能，用于扩展 Claude 的功能。每个 Skill 都包含 Claude 在相关时自动使用的指令、元数据和可选资源。

将 Skills 视为教学模块。当您安装一个 Skill 时，Claude 会获得关于如何在您的项目中处理特定任务的专业知识。这无需手动提示即可完成——Claude 会识别何时适用某个 Skill，并无缝地整合其指令。

根据官方 Claude Code 文档，Skills 支持对 Skill 内容中的动态值进行字符串替换。这允许进行灵活、上下文感知且能适应不同场景的自动化。

三级加载系统

Skills 使用分层加载方法，在功能性和效率之间取得平衡：

级别	加载时间	代币成本	内容
级别 1：元数据	始终（启动时）	每个 Skill 约 100 个代币	来自 YAML Frontmatter 的名称和描述
级别 2：指令	触发 Skill 时	取决于内容	完整的指令和指南
级别 3：资源	按需加载	取决于文件大小	脚本、模板、参考文档

这个分级系统意味着您的上下文窗口保持高效。元数据会立即加载，以便 Claude 知道存在哪些 Skills，而详细指令仅在实际需要时消耗代币。

Skills 与其他自定义方法的区别

Claude Code 提供了多种自定义方法。Skills 占据了一个特定的利基市场：

CLAUDE.md 文件 存储项目范围的指令和上下文，这些指令和上下文始终加载。将这些用于高级项目信息、架构决策和广泛适用的持续性指南。
斜杠命令 存储在 .claude/commands/ 中的手动调用的快捷方式。这些需要用户明确操作才能触发。
Skills 根据上下文自动激活。它们非常适合应在特定情况下自动应用而无需手动干预的专业工作流程。
子代理 作为独立的代理实例运行，拥有自己的上下文、模型选择和工具访问权限。根据官方文档，子代理通过委托给专业代理来帮助管理复杂任务。

Claude Code 内置 Skills

Claude Code 包含几个捆绑的 Skills，展示了该系统的功能。这些 Skills 开箱即用，可处理常见的开发工作流程。

/batch Skill 可并行协调代码库的大规模更改。它会研究代码库，将工作分解为 5 到 30 个独立单元，并在执行前提出计划。这对于重构操作或在多个文件中应用一致的更改尤其有价值。

内置 Skills 具有双重目的。它们提供即时效用，同时提供创建自定义 Skill 的模板。检查它们的结构可以揭示指令清晰度、资源组织和元数据配置的最佳实践。

在一个地方找到 Claude 和 AI 工具积分

如果您正在研究 Claude Code Skills，也可以看看 Claude 和您工作流程周围的其他工具可用的福利。Get AI Perks 集中了 AI 和云工具的初创公司积分和软件折扣。Get AI Perks 平台为创始人提供了 200 多项优惠，以及要求、批准指南和申领说明。

正在寻找 Claude 积分和福利？

查看 Get AI Perks：

浏览 Claude 和 Anthropic 的优惠
比较 AI 工具的福利条件
在一个地方查找其他初创公司软件折扣

👉 访问 Get AI Perks 探索当前的 AI 工具福利。

在五分钟内创建您的第一个自定义 Skill

构建一个基本的 Skill 需要最少的设置。该过程遵循一个简单的模式，在第一次尝试后会变得熟练。

第一步：创建 Skills 目录

导航到您的项目根目录并创建 Skills 目录结构：

mkdir -p .claude/skills

此 .claude 目录是 Claude Code 自定义项的中央配置位置。skills 子目录包含所有 SKILL.md 文件。

第二步：编写您的第一个 SKILL.md 文件

在 .claude/skills/code-review.md 创建一个新文件，结构如下：

—
name: 代码审查
description: 进行彻底的代码审查，重点关注安全性、性能和可维护性
—

审查代码时：
1. 检查常见的安全漏洞（SQL 注入、XSS、身份验证问题）
2. 识别性能瓶颈（N+1 查询、效率低下的算法）
3. 验证错误处理和边缘情况
4. 评估代码的可维护性和可读性
5. 提供包含代码示例的具体改进建议

YAML Frontmatter（在 — 标记之间）定义了元数据。名称会在 Claude 引用 Skill 时显示。描述有助于 Claude 确定该 Skill 何时适用。

Frontmatter 下面的所有内容都将成为 Skill 激活时 Claude 遵循的指令集。

第三步：测试 Skill

在您的项目目录中启动 Claude Code。Skill 会自动加载。要求 Claude 审查一个代码文件——它将应用 code-review Skill 的指南，而无需额外提示。

就是这样。三个步骤，五分钟，您就通过自定义逻辑扩展了 Claude 的功能。

创建和部署自定义 Claude Code Skill 的三步流程，通常在五分钟内完成。

高级 Skill 模式和字符串替换

基本 Skill 可用于静态指令。当 Skills 动态适应不同上下文时，真正的强大之处就显现出来了。

通过字符串替换进行动态参数

Skills 支持变量替换，将运行时值注入指令。官方文档定义了以下可用替换：

$ARGUMENTS 捕获调用 Skill 时传递的所有参数。如果 $ARGUMENTS 不出现在内容中，参数将自动附加为 ARGUMENTS: <value>。
$ARGUMENTS[N] 按位置（零索引）访问特定参数。

这是一个实际示例——一个接受表名的数据库迁移 Skill：

—
name: 生成迁移
description: 为架构更改创建数据库迁移
—

为：$ARGUMENTS[0] 创建迁移文件

包括：
– 基于时间戳的文件名
– Up 和 Down 方法
– 外键的正确索引
– 回滚安全检查

使用参数调用时，Claude 会在处理指令之前替换值。这消除了对不同参数的类似任务的重复提示。

用于复杂 Skills 的资源捆绑

Skills 可以引用外部资源——模板、脚本或参考文档。这些资源是按需加载的（加载层级的级别 3），直到实际需要时才保持上下文的高效性。

在 SKILL.md 文件旁边创建一个 resources 目录：

.claude/skills/
├── api-endpoint.md
└── api-endpoint-resources/
├── endpoint-template.ts
└── test-template.spec.ts

在 Skill 指令中引用这些资源。Claude 在处理指令的该部分时会加载它们。

每个开发者都应具备的基本 Skills

某些开发模式经常重复出现，以至于预构建的 Skills 可提供即时价值。根据社区讨论和官方 Skills 存储库，以下类别被证明是最有益的。

代码质量和审查 Skills

自动代码审查可以在人工审查之前发现问题。全面的审查 Skill 可能会检查：

特定于您的堆栈的安全漏洞
代码库中的性能反模式
与团队编码标准的符合性
测试覆盖率差距
文档完整性

社区资源中提到的安全验证 Skills 在检测漏洞方面显示出高准确率。

测试和质量保证

测试 Skills 可根据您的框架偏好自动生成测试。精心设计的测试 Skill 会理解：

您的测试框架（Jest、Pytest、RSpec）
覆盖率要求和阈值
模拟模式和策略
边缘情况识别
集成与单元测试的区别

文档生成

文档通常落后于代码更改。Skills 可以通过自动生成以下内容来保持一致性：

从代码注释生成 API 文档
从项目结构生成 README 文件
从提交消息生成变更日志条目
为复杂逻辑生成内联代码注释

特定于框架的 Skills

领域特定 Skills 对特定框架或库的编码最佳实践。这些可确保 Claude 正确应用框架约定，而无需不断提醒。

React Skills 可能会强制执行 Hooks 用法模式。Django Skills 可能会确保正确使用 ORM 和管理迁移。正如官方文档中提到的，数据科学 Skills 可以明确禁用代码执行工具，并专注于分析工作流程。

Skills 配置和管理

随着 Skill 集合的增长，组织变得至关重要。Claude Code 提供了多种机制来管理不同范围的 Skills。

Skill 发现和加载

根据官方文档，Skills 可以在多个级别上进行配置，并定义了优先级：

位置	范围	优先级	如何创建
–agents CLI 标志	当前会话	1（最高）	启动时传递 JSON
.claude/skills/	项目级别	2	在目录中创建 SKILL.md
~/.claude/skills/<skill-name>/SKILL.md	用户全局	3	跨所有项目可用。
插件提供	插件范围	4（最低）	通过插件安装

此优先级系统允许会话特定的覆盖，同时维护合理的默认值。项目 Skills 覆盖用户 Skills，从而防止全局配置与项目特定需求发生冲突。

跨团队共享 Skills

团队受益于标准化的 Skills。有几种分发方法效果很好：

版本控制：将 .claude/skills/ 提交到您的存储库。团队成员在拉取更改时会自动收到 Skill 更新。
集中式存储库：维护一个项目引用的团队 Skills 存储库。使用 git 子模块或包管理来分发更新。
插件打包：将相关 Skills 打包成插件，以便于分发和版本管理。
GitHub 上的官方 Anthropic Skills 存储库演示了这种模式。它包含任何人都可以引用或克隆的社区贡献的 Skills。

Skills 与子代理：何时使用哪种

Skills 和子代理都扩展了 Claude 的功能，但服务于不同的架构需求。理解区别可以避免笨拙的实现。

Skills 在主会话上下文内工作。它们修改 Claude 处理任务的方式，但不会创建单独的代理实例。当以下情况时使用 Skills：

向主会话添加专业知识
强制执行标准或约定
提供模板或模式
自动化简单的 DPA 流程

子代理作为独立的代理实例运行，具有隔离的上下文。根据官方文档，子代理支持使用与主会话相同的逻辑进行自动压缩，默认情况下，自动压缩在容量达到约 95% 时触发。

当出现以下情况时，请使用子代理：

任务需要不同的模型选择（Haiku 用于简单任务，Opus 用于复杂推理）
上下文隔离可防止混淆
并行执行可加快 DPA 流程
应限制专业工具的访问

官方文档提供了示例，例如 Bash 子代理（用于在单独的上下文中运行终端命令）和 statusline-setup（在配置状态行时使用 Sonnet）。

这是决策框架：如果 Claude 需要不同的功能或上下文边界，请使用子代理。如果 Claude 在当前会话中需要专业知识，请使用 Skills。

与 Model Context Protocol 集成

Model Context Protocol (MCP) 提供了另一种扩展机制。Skills 和 MCP 服务于互补的目的。

MCP 服务器将外部数据源和工具暴露给 Claude。它们处理身份验证、数据获取和 API 交互。将 MCP 视为扩展 Claude 可以访问的内容。

Skills 定义了 Claude 如何使用可用功能。它们编码了工作流程、标准和领域知识。将 Skills 视为扩展 Claude 知道如何做的事情。

这两个系统协同工作。MCP 服务器可能提供对公司内部文档系统的访问。Skill 教会 Claude 如何编写符合公司标准并能通过 MCP 服务器发布的文档。

根据官方文档，Skills 可以限定于特定的 MCP 服务器，从而实现对特定数据源可用时哪些 Skills 会激活的细粒度控制。

性能优化和代币管理

Skills 会消耗上下文代币。设计不佳的 Skills 可能会导致上下文窗口膨胀并减慢响应速度。

代币预算意识

根据官方文档，旧模型的思考使用了固定预算，最多可达输出预算的 31,999 个代币。三级加载系统有助于管理此问题：

级别 1 元数据（每个 Skill 约 100 个代币）始终加载。保持描述简洁但具有足够的信息量，以便 Claude 确定相关性。

级别 2 指令在触发时加载。编写针对特定 Skill 目的的专注指令，避免无关信息。

级别 3 资源按需加载。将大型参考材料打包为资源，而不是直接放在指令中。

努力水平配置

Claude Code 允许进行努力水平调整，这会影响思考的深度。根据官方文档，这是调整速度和推理深度之间权衡的推荐方法。

范围	如何配置	详情
努力水平	运行 /effort，在 /model 中调整，或设置 CLAUDE_CODE_EFFORT_LEVEL	控制 Opus 4.6 和 Sonnet 4.6 的思考深度
ultrathink 关键字	在提示中包含“ultrathink”	在 Opus 4.6 和 Sonnet 4.6 上为该回合设置高努力度

对于需要深度推理的复杂 Skills，请考虑在 Skill 指令中嵌入 ultrathink 关键字。这可确保 Claude 在无需手动干预的情况下应用适当的努力。

真实世界实现模式

理论不如实践重要。这些模式源于生产部署。

调试专家模式

创建一个专门的调试 Skill，该 Skill 应用系统化的故障排除。官方文档建议的结构如下：

针对每个问题，提供：根本原因解释、支持诊断的证据、具体的代码修复、测试方法、预防建议。重点是解决根本问题，而不是症状。

这种模式将 Claude 从提出快速修复方案转变为进行全面的问题解决方案。

批量处理模式

对于影响多个文件的操作，请利用内置的 /batch Skill 或创建类似的模式。批量处理：

在开始前研究完整范围
将工作分解为独立单元
呈现执行计划供审查
在可能的情况下并行执行更改

这种方法可以防止级联错误，并在计划被证明不正确时允许回滚。

标准执行模式

将团队约定编码为自动激活的 Skills。TypeScript 标准 Skill 可能会强制执行：

函数参数上的严格类型注解
导出的函数有显式返回类型
一致的错误处理模式
特定的导入组织

这些 Skills 可作为自动代码审查器，在人工审查之前捕获约定违规。

面向科学和研究工作流程的 Skills

研究团队有独特的需求。根据关于科学家如何使用 Claude 的官方案例研究，斯坦福大学的 Lundberg Lab 使用 Claude 来颠覆传统的假设生成。

他们不是手动整理基因列表，而是使用 Claude 根据文献和数据系统地探索各种可能性。根据 Anthropic 的案例研究，集中的筛选对研究实验室来说是重大的财务投资。Skills 可以编码这种研究方法。

研究 Skill 可能会：

系统地搜索文献数据库
跨研究交叉引用发现
根据数据模式生成假设
建议实验设计
为出版物格式化结果

官方文档中的数据科学家示例展示了如何创建领域特定的子代理，这些子代理明确禁用代码执行工具并专注于分析工作流程。

故障排除常见 Skill 问题

Skills 有时会发生故障。大多数问题都可以追溯到少数常见原因。

Skill 未加载

检查文件位置和名称。Skills 必须位于 .claude/skills/ 中，扩展名为 .md。验证 Frontmatter 使用有效的 YAML 语法——缺少冒号或缩进不正确都会导致解析失败。

使用详细日志运行 Claude Code，以查看哪些 Skills 已成功加载。缺失的 Skills 通常表示文件路径或权限问题。

Skill 激活不正确

过于宽泛的描述会导致 Skills 在意外的上下文中触发。使描述更具体，说明 Skill 何时适用。

不要说“有助于数据库工作”，而要写“创建遵循我们架构版本控制约定的 PostgreSQL 迁移”。

指令被忽略

如果 Skill 指令与用户的明确提示冲突，Claude 可能不会遵循。用户指令始终优先于 Skill 默认值。

或者，指令可能过于模糊。Skill 内容中的具体示例可以显着提高依从性。向 Claude 展示什么是好的输出。

超出代币预算

过多的 Skills 或过于冗长的指令会耗尽上下文。审计加载的 Skills——删除很少使用的 Skills。将详细的参考材料移至级别 3 资源。

如果上下文经常填满，CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 环境变量可以更早地触发压缩。

对开发者技能形成的影响

Anthropic 发表了研究，检查 AI 协助如何影响编码技能的发展。这项研究是一项针对软件开发者的随机对照试验，调查了认知卸载是否会阻碍技能增长。

根据研究，遇到更多错误的参与者可能会通过独立解决这些错误来提高他们的调试技能。当按 AI 交互模式分组时，过度依赖 AI 进行代码生成或调试与平均考试分数低于 40% 相关。

研究指出：“如果初级工程师的技能发展因使用 AI 而受阻，那么生产力优势可能会以验证 AI 编写代码所需的技能为代价。”

这一发现对 Skill 设计有影响。Skills 应增强专业知识，而不是取代学习。请考虑以下指南：

解释，而不仅仅是执行：Skills 应包含教育性上下文，解释为什么某些方法有效。

鼓励验证：在 Skill 工作流程中构建审查步骤，而不是假设自动正确性。

渐进式披露：初级开发人员可能会从更冗长的传授概念的 Skills 中受益，而高级开发人员则偏爱简洁、面向操作的 Skills。

未来方向和生态系统增长

Skills 生态系统不断扩展。社区贡献的 Skills 正在激增。官方 Anthropic Skills 存储库展示了开放协作如何加速能力增长。开发人员为利基框架、语言和工作流程贡献专业 Skills。

插件系统正在成熟。根据官方文档，可以通过插件以编程方式将 Skills 与自定义命令、代理和 MCP 服务器捆绑在一起。这允许将复杂的 PPA 功能包作为单个单元分发。

领域特定的 Skill 集合正在出现。医学研究团队、金融分析师和科学计算组正在创建专业 Skill 库，这些库编码了特定领域的最佳实践。

与 CI/CD 流水线的集成正在扩展。执行自动代码审查、安全扫描和合规性检查的 Skills 正在被纳入自动化工作流程。

常见问题解答

同时可以激活多少个 Skills？

没有硬性限制，但实际限制源于代币预算。所有 Skills 的级别 1 元数据在启动时加载——每个大约消耗 100 个代币。拥有数百个 Skills，仅元数据就可能消耗大量上下文。总的来说，团队发现 20-50 个设计精良的 Skills 可以提供全面的覆盖而不会膨胀。注重质量而非数量。

Skills 可以调用其他 Skills 或创建链条吗？

Skills 不会显式调用彼此，但当上下文适宜时，Claude 可以对单个任务应用多个 Skills。如果任务要求与多个 Skill 描述匹配，Claude 将从每个 Skill 中整合相关的指令。这会创建涌现的工作流程，而无需显式的链式逻辑。

Skills 是否适用于所有 Claude 模型？

Skills 适用于所有 Claude 模型，但行为可能因模型的 PPA 而异。根据官方文档，Opus 4.6 和 Sonnet 4.6 支持影响思考深度的努力水平配置。旧模型使用固定的思考预算。设计 Skills 时应使其独立于模型——依赖清晰的指令而不是模型特定的功能。

如何更新 Skill 而不破坏现有工作流程？

Claude Code 重新加载时，Skill 更新会立即应用。对于破坏性更改，请考虑通过文件名（api-v1.md、api-v2.md）进行版本控制，并逐步更新引用。在部署到团队存储库之前，在隔离的项目中测试更新的 Skills。版本控制 .claude/skills/ 在更新导致问题时提供回滚能力。

Skills 可以访问环境变量或密钥吗？

Skills 是由 Claude 处理的 Markdown 文件——它们不直接执行代码。但是，Skills 可以指示 Claude 使用可用的工具或访问环境变量的 MCP 服务器。切勿在 Skill 文件本身中嵌入密钥。相反，教会 Skills 通过适当的安全渠道检索凭据。

Skill 和斜杠命令之间有什么区别？

斜杠命令需要显式调用——用户键入 /command-name 来触发它们。当上下文与其描述匹配时，Skills 会自动激活。将斜杠命令用于只应按需运行的工作流程。将 Skills 用于应在相关时自动应用的约定和标准。

如何排除不起作用的 Skill？

从 Frontmatter 验证开始——YAML 语法错误会完全阻止加载。检查文件位置（.claude/skills/）和权限。查看 Claude Code 启动日志以获取加载错误。使用详细描述进行测试，这些描述明确说明了 Skill 应何时适用。如果指令被忽略，请添加显示所需行为的具体示例。简化复杂的 Skills 以隔离哪个部分导致问题。

结论：制定您的 Skill 策略

Claude Code Skills 将 AI 编码助手从被动转变为主动。您只需编写一次偏好和标准，而无需不断提醒 Claude。Claude 会自动、一致且可靠地应用这些知识。

从小处着手。创建一个 Skill 来解决您最频繁的手动提示。测试它。完善它。然后逐步扩展。

最成功的 Skill 实现具有共同特征：它们解决了实际痛点，它们像代码一样维护（版本控制、审查、文档化），并且它们在自动化和学习之间取得了平衡。

Skills 不仅仅是生产力快捷方式。它们是知识捕获系统，以可执行的形式保存团队专业知识。随着团队的发展，Skills 不仅记录做什么，还记录为什么。

准备好开始了吗？在您当前的项目中创建 .claude/skills/。编写一个简单的 Skill 来解决一个重复的任务。启动 Claude Code 并观看它的运行。这是更智能的开发工作流程的开始。

探索官方 Anthropic Skills 存储库以获取社区贡献的示例。查阅 Claude Code 文档以了解高级模式。加入有关实现策略的讨论，并分享对您的团队有用的内容。

Skills 生态系统随着每一次贡献而变得更强大。构建一些有用的东西，然后分享它。