加载中

什么是技能?

第 1 课9 分钟
本节课内容学完后,您将能够
  • 定义什么是 Claude Code 技能以及它们的工作原理
  • 说明技能存放的位置(个人目录与项目目录)
  • 区分技能、CLAUDE.md 和斜杠命令
  • 识别技能是合适的自定义工具的场景

什么是技能?

加载中

什么是技能? · 3 min

摘要文字记录

本视频介绍了技能——可重复使用的 markdown 文件,用于教会 Claude Code 如何自动处理特定任务。您不必每次要求 Claude 审查 PR 或编写提交 消息时都重复说明,而是只需编写一次技能,Claude 就会在任务 出现时应用它。本视频介绍了什么是技能、它们存放在哪里,以及它们与 其他 Claude Code 自定义选项的比较。

关键要点

  • 技能是包含说明的文件夹,Claude Code 可以发现并使用它们来更准确地处理任务。每个技能都存放在一个 SKILL.md 文件中,该文件的前置元数据中包含名称和描述
  • Claude 使用描述来将技能与请求进行匹配。 当您要求 Claude 做某件事时,它会将您的请求与可用的技能描述进行比较,并激活匹配的技能
  • 个人技能存放在 ~/.claude/skills 中,并跟随您所有项目。项目技能存放在代码仓库内的 .claude/skills 中,并与克隆该仓库的任何人共享
  • 技能按需加载——与 CLAUDE.md(它会加载到每次对话中)或斜杠命令(需要显式调用)不同,技能会在 Claude 识别到相应情况时自动激活
  • 如果您发现自己反复向 Claude 解释同一件事,那就说明有一个技能等待被编写出来

每次向 Claude 解释您团队的编码标准时,您都在重复自己。每次 PR 审查,您都要重新描述您希望反馈结构是怎样的。每次提交消息,您都要提醒 Claude 您偏好的格式。技能解决了这个问题。

技能是一个 markdown 文件,它教会 Claude 如何一次性完成某件事。之后 Claude 会在相关的任何时候自动应用这一知识。

什么是技能

技能是包含说明和资源的文件夹,Claude Code 可以发现并使用它们来更准确地处理任务。每个技能都存放在一个 SKILL.md 文件中,该文件的前置元数据中包含名称和描述。

在代码编辑器中打开的 pr-review SKILL.md,其中包含诸如不得硬编码密钥和 Pydantic 架构等审查检查项。

描述是 Claude 决定是否使用某个技能的依据。当您要求 Claude 审查 PR 时,它会将您的请求与可用的技能描述进行匹配,并找到相关的那个。Claude 读取您的请求,将其与所有可用的技能描述进行比较,并激活匹配的技能。

以下是技能前置元数据的样子:

yaml
---
name: pr-review
description: Reviews pull requests for code quality. Use when reviewing PRs or checking code changes.
---

在前置元数据下方,您编写实际的说明——您的审查清单、格式偏好,或者 Claude 需要了解的与该任务相关的任何内容。

技能存放在哪里

您可以根据谁需要这些技能,将它们存储在不同的位置:

  • 个人技能存放在 ~/.claude/skills(您的主目录)中。这些技能会跟随您所有的项目——您的提交消息风格、您的文档格式、您喜欢代码被解释的方式。
  • 项目技能存放在您代码仓库根目录下的 .claude/skills 中。任何克隆该仓库的人都会自动获得这些技能。团队标准就存放在这里,例如您公司的品牌指南、网页设计偏好的字体和颜色。

在 Windows 上,个人技能存放在 C:/Users/<your-user>/.claude/skills 中。

项目技能会与您的代码一起提交到版本控制中,因此整个团队都可以共享它们。

技能 vs. CLAUDE.md vs. 斜杠命令

Claude Code 有多种方式来自定义行为。技能之所以独特,是因为它们是自动化且针对特定任务的。以下是它们的比较:

  • CLAUDE.md 文件会加载到每次对话中。如果您希望 Claude 始终使用 TypeScript 的严格模式,那应该写在 CLAUDE.md 中。
  • 技能会在匹配您的请求时按需加载。Claude 最初只加载名称和描述,因此它们不会占满您的整个上下文窗口。当您在调试时,不需要将 PR 审查清单放入上下文中——只有当您实际请求审查时它才会加载。
  • 斜杠命令需要您明确输入才能使用。技能不需要。当 Claude 识别到相应情况时,它会自动应用这些技能。

当 Claude 将某个技能与您的请求匹配时,您会在终端中看到它加载:

在请求审查 sg-221 分支上的拉取请求后,一行 Skill pr-review 显示"Successfully loaded skill"。

何时使用技能

技能最适合应用于特定任务的专业知识:

  • 团队遵循的代码审查标准
  • 您偏好的提交消息格式
  • 您组织的品牌指南
  • 特定类型文档的文档模板
  • 特定框架的调试清单

经验法则很简单:如果您发现自己反复向 Claude 解释同一件事,那就说明有一个技能等待被编写出来。

课程反思

  • 回想一下您最近与 Claude Code 的交互。哪些说明是您发现自己在反复重复的?一个技能本可以如何为您节省时间?
  • 思考一下您团队的工作流程。哪些标准或流程最能从被编码为技能中受益?

下一步

在下一课中,您将从零开始创建您的第一个技能,并了解 Claude Code 在后台如何发现、匹配和加载技能。