Claude Skill1. 概念介绍1.1 什么是 Skill简单来说Skill 就是 Claude Code 的专业技能包。Claude 自带了一些内置 Skill如代码审查、安全检查你也可以创建自己的自定义 Skill如文档格式化或者安装别人通过插件分享的 Skill。你可以把它想象成手机上的快捷指令或者游戏里角色的技能栏——平时你和 Claude 对话是普通的聊天而当你输入/skill名称或者用自然语言描述你的需求时Claude 就会按照预设的流程去执行特定任务。举个例子同样是对代码审查的需求有三种不同的方式普通对话你说这段代码有什么问题吗Claude 凭经验给出一些泛泛的建议手动触发 Skill你输入/reviewClaude 按照标准化审查流程系统地检查代码质量、安全问题、潜在 bug 等自动触发 Skill你说帮我做一下安全检查Claude 识别到这句话匹配了security-review的描述自动启动安全审查流程——你不需要记得具体的命令名称1.2 Skill 的作用Skill 解决了几个痛点提高效率不用每次都写一大堆提示词一个命令搞定结果一致每次执行相同的 skill走的是同一套流程结果更可预期专业聚焦每个 skill 只做一件事效果比泛泛的对话要好可复用一次配置反复使用个性化定制内置 Skill 覆盖通用场景但每个项目都有独特需求。自定义 Skill 让你能把项目专属的工作流固化下来比如团队的文档格式规范、特定的部署检查流程无需每次重新描述1.3 内置 Skill 与自定义 SkillClaude Code 的 Skill 有三种来源来源说明典型用途内置 Skill程序自带开箱即用共 9 个代码审查、安全检查、项目初始化等通用场景自定义 Skill自己编写放在~/.claude/skills/或.claude/skills/团队专属工作流、个人常用任务插件 Skill通过/plugin install安装别人写好的 Skill社区共享的专业技能如文档处理、数据转换等三者的使用方式完全一样——都是输入/skill名称来调用。区别只在于来源和安装方式。内置 Skill 覆盖了常见开发场景详见附录速查表但实际开发中你很可能会需要针对自己项目特点的专属 Skill这时候自定义 Skill 就派上用场了。具体如何创建自定义 Skill见 2.3 如何安装/创建自定义 SkillGitHub 开源 Skill 项目的详细介绍见 4. 笔者用到的 GitHub 开源 Skill 项目。2. 上手指南2.1 如何查看已安装的 Skill最简单的方式在 Claude Code 中输入/help可以查看所有可用的命令和 skill。另外在每次对话的开头Claude 也会收到系统提示列出当前可用的 skill。比如本次对话中以下技能可供使用- update-config: 通过 settings.json 配置 Claude Code- keybindings-help: 自定义键盘快捷键- simplify: 审查代码质量并优化- loop: 定时/循环执行任务- claude-api: 构建、调试和优化 Claude API 应用- init: 初始化 CLAUDE.md 文件- review: 审查 Pull Request- security-review: 安全审查- fewer-permission-prompts: 减少权限提示2.2 如何使用 Skill基本语法直接输入/加上 Skill 名称/review/simplify/claude-api带参数使用有些 Skill 支持传入参数/loop 5m /review # 每 5 分钟执行一次 review实际操作示例假设你想对当前代码进行安全审查你/security-reviewClaude启动安全审查流程检查当前分支的所有待提交更改又比如你想看看代码能不能优化你/simplifyClaude审查代码的复用性、质量和效率然后自动修复发现的问题自定义 Skill 的调用方式和内置完全一样。比如本项目中有一个document-format-skills你/document-format-skillsClaude识别到这是一个文档格式处理技能按照预设流程处理 .docx 文件就这么简单不需要写复杂的提示词一个斜杠命令就够了。自动触发除了手动输入斜杠命令Claude 还会根据你的对话内容自动识别并调用 Skill。原理是 Claude 将你说的话与每个 Skill 的description做匹配——匹配上就会自动调用不需要你手动输入/skill名称。例如你帮我检查一下代码有没有安全问题Claude识别到需求匹配 security-review 的 description自动触发安全审查流程你这份文档格式太乱了帮我整理一下Claude识别到需求匹配 document-format-skills 的 description自动触发文档格式化几个要点自动触发是 Claude 基于语言理解的判断不是精确的关键词匹配所以偶尔可能匹配不上或误触发如果你确定要用某个 Skill手动输入/skill名称更精确可靠description写得越好明确描述触发条件自动触发的准确率越高将user-invocable设为false的 Skill 不会出现在斜杠菜单中只能通过自动触发调用2.3 如何安装/创建自定义 SkillSkill 存放位置自定义 Skill 放在两个位置之一级别目录说明全局~/.claude/skills/所有项目都能用项目级项目根目录下.claude/skills/只有当前项目能用创建一个自定义 Skill三步走第 1 步建目录在~/.claude/skills/下新建一个文件夹名字用小写字母加连字符如my-test~/.claude/skills/└── my-test/第 2 步写 SKILL.md在my-test/目录下创建SKILL.md格式如下---name: my-testdescription: This skill should be used when the user asks to 测试一下 or 检查某功能.---# 测试 Skill1. 读取当前目录下的所有 .py 文件2. 统计每个文件的行数3. 输出一份汇总报告就这么简单——YAML frontmatter 写上名称和触发描述Markdown body 写具体要执行的步骤。第 3 步保存即生效Claude Code 会自动扫描~/.claude/skills/和.claude/skills/目录保存后无需重启热重载立即生效。输入/my-test就能调用。Frontmatter 常用字段说明字段必需说明name是Skill 名称用小写字母连字符description是触发条件写什么时候该用这个 skillversion否版本号model否指定模型sonnet/opus/haikuallowed-tools否限定可用的工具如Read, Write, Bash(git:*)argument-hint否参数提示如[file-path]user-invocable否是否出现在斜杠菜单中默认 true写 description 的技巧用第三人称写触发条件比如 This skill should be used when the user asks to 做某事。Claude 就是靠这个 description 来判断何时触发你的 Skill。通过插件安装 Skill除了自己写还可以通过插件安装现成的 Skill/plugin install 插件名插件中包含的 Skill 会自动被识别输入/skills就能看到。3. 进阶内容3.1 Skill 的触发机制Skill 有两种触发方式