title: Skill 技能系统完全指南一初识 Claude Code Skill 系统date: 2026-07-10category: AI 开发工具tags: [Claude Code, Skill, 技能系统, 入门, 扩展]Skill 技能系统完全指南一初识 Claude Code Skill 系统Claude Code 不只是个聊天机器人它还是一个可编程的工具平台。Skill 就是这个平台的技能插件——每个 Skill 定义了 Claude 在特定场景下该做什么、怎么做。本篇带你理解 Skill 的本质认识内置的 Skill 全家桶找到开启 Skill 大门的第一把钥匙。一、什么是 SkillSkill技能是 Claude Code 中一种声明式的行为扩展机制。你可以把 Skill 理解成 Claude 的专业技能证书没有 Skill 时Claude 是个通用程序员——什么都会一点但不够专业有了 SkillClaude 就变成了有专长的工程师——懂安全审计、会 DevOps、能写文档每个 Skill 本质上是一个 Markdown 文件.md里面包含了组成部分说明触发条件什么情况下这个 Skill 会被激活关键词、文件路径、用户指令系统提示词Claude 激活 Skill 后的人设和行为准则操作步骤可选的详细执行流程指南工具清单该 Skill 需要使用哪些 Claude Code 的工具当 Skill 被触发时Claude 会临时变身为该 Skill 定义的专家角色按照预设的流程执行任务。1.1 Skill vs Agent vs Workflow这三个概念容易混淆但它们各有分工Agent 角色谁来做 Skill 方法怎么做 Workflow 流程按什么顺序做Agent决定让谁来做——后端开发 Agent、前端开发 Agent、安全审计 AgentSkill决定用什么方法做——代码审查 Skill、调试 Skill、文档生成 SkillWorkflow决定按什么顺序做——先审查 → 再修复 → 最后验证三者可以组合使用一个 Workflow 可以调用多个 Agent每个 Agent 在执行过程中可以激活多个 Skill。二、Skill 是怎么工作的2.1 触发机制Claude Code 有两种触发 Skill 的方式方式一自动触发隐式当你说的话匹配到某个 Skill 定义的关键词或场景时Claude 会自动加载该 Skill。你说帮我做一次安全审计 ↓ Claude 检测到安全审计关键词 ↓ 自动加载 security-review Skill ↓ 按照 Skill 定义的流程执行安全审计方式二手动触发显式通过/命令直接调用某个 Skill你说/code-review 审查我刚才的改动 ↓ Claude 直接激活 code-review Skill ↓ 执行代码审查流程2.2 Skill 的生命周期┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ 用户发言 │ ──→ │ 匹配 Skill │ ──→ │ 执行 Skill │ ──→ │ 返回结果 │ │ (输入) │ │ (加载提示词)│ │ (调用工具) │ │ (输出) │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ ↑ │ │ ▼ └────────────────── 对话继续 ◀─────────────────────┘匹配Claude 分析你的发言判断是否有匹配的 Skill加载将 Skill 的系统提示词注入到对话上下文中执行按照 Skill 定义的流程调用工具完成任务返回输出结果Skill 退出回到普通对话模式三、内置 Skill 全家桶一览Claude Code 自带了一系列开箱即用的 Skill涵盖开发全流程。下面按类别介绍3.1 开发流程类Skill 名称触发场景作用init新项目初始化引导创建 CLAUDE.md、项目结构建议verify验证改动端到端验证代码变更是否生效run运行应用启动项目应用观察实际效果3.2 代码质量类Skill 名称触发场景作用code-review代码审查审查变更的正确性、复用性、效率simplify代码简化寻找可简化和重构的代码片段security-review安全审计全面的安全漏洞审查3.3 协作沟通类Skill 名称触发场景作用superpowers:brainstorming创意/方案设计正式开发前的需求澄清和方案设计superpowers:executing-plans执行计划按审批后的计划执行开发superpowers:requesting-code-review请求审查完成开发后请求代码审查superpowers:receiving-code-review接收审查处理收到的审查反馈3.4 工程化类Skill 名称触发场景作用superpowers:systematic-debugging调试问题系统化排查 Bug 的方法论superpowers:test-driven-developmentTDD 开发测试驱动开发流程superpowers:finishing-a-development-branch分支合并开发完成后的集成策略update-config配置修改修改 settings.json、权限、环境变量fewer-permission-prompts权限优化减少重复的权限确认弹窗3.5 专项工具类Skill 名称触发场景作用ssh-agent远程服务器SSH 连接、远程命令执行dataviz数据可视化图表、仪表盘的设计与生成keybindings-help快捷键配置自定义键盘绑定loop周期性任务定时重复执行某个操作tensorart-generateAI 绘图调用 TensorArt 生成图片/视频3.6 学习研究类Skill 名称触发场景作用superpowers:writing-skills编写 Skill创建和验证新的 Skillsuperpowers:using-superpowers技能发现引导发现和使用可用 Skillclaude-apiAPI 查询查询 Claude API 参数、定价、模型信息3.7 代码管理Skill 名称触发场景作用superpowers:using-git-worktrees工作树创建和管理 git worktree 隔离环境superpowers:writing-plans编写计划在动手前制定实施计划superpowers:verification-before-completion完成前验证提交前的最终验证总计 20 个内置 Skill覆盖了从项目初始化、开发、审查、调试到部署的完整生命周期。四、第一个 Skill 实战体验代码审查光说不练假把式。我们来体验一个最简单的 Skill——code-review。4.1 场景假设你刚写完一个用户登录接口想让 Claude 审查一下代码。4.2 操作步骤第一步启动 Claude Codecdyour-project claude第二步触发 code-review Skill/code-review 审查我刚才写的登录接口第三步观察结果Claude 会激活 code-review Skill按照预设的审查维度检查你的代码正在执行 code-review Skill... 审查维度正确性、复用性、安全性、效率 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ⚠️ 发现 3 个问题 1. [安全性] 第 23 行密码校验前未做输入长度限制存在暴力破解风险 建议添加 maxLength 校验最大长度 128 字符 2. [效率] 第 45 行查询用户时使用了 SELECT *建议只查需要的字段 建议改为 LambdaQueryWrapper 指定字段 3. [复用性] 第 67-89 行错误处理逻辑与项目中其他接口重复 建议抽取到统一的 ExceptionHandler 中4.3 这是什么原理当你输入/code-review时发生了什么你输入 /code-review ↓ Claude 识别到 / 开头的命令 ↓ 查找名为 code-review 的 Skill 定义 ↓ 加载 Skill 的系统提示词包含审查维度、评分标准、输出格式 ↓ 按照 Skill 定义的流程执行 1. 读取当前 git diff 2. 按维度逐项检查 3. 生成结构化报告 ↓ 输出审查结果Skill 的本质就是给 Claude 装了一个专家模块——平时它不知道该怎么审查代码但加载了 code-review Skill 后它就变成了一个专业的 Code Reviewer。五、Skill 的存储位置了解 Skill 存在哪里是后续自定义 Skill 的基础。5.1 内置 Skill内置 Skill 由 Claude Code 自带位于安装目录中。你不能也不应该修改它们。5.2 项目级 Skill在项目根目录的.claude/skills/下创建自定义 Skillyour-project/ ├── .claude/ │ └── skills/ │ ├── security-audit.md # 安全审计 Skill │ ├── api-doc-gen.md # API 文档生成 Skill │ └── deploy-check.md # 部署检查 Skill ├── src/ └── CLAUDE.md项目级 Skill 只对当前项目生效随代码一起纳入版本管理。5.3 用户级 Skill在~/.claude/skills/下创建对所有项目生效~/.claude/ └── skills/ └── my-generic-skill.md # 全局可用的 Skill适合存放那些跨项目通用的技能定义。六、如何发现可用 Skill6.1 自然语言探索最直接的方式——直接问 Claude我可以用什么 Skill 来审查代码Claude 会自动扫描可用的 Skill 列表给出建议。6.2 查看 Skill 列表在 Claude Code 的对话中每个可用 Skill 都会在系统提示中自动注册。当你提到相关场景时Claude 会想起对应的 Skill。你也可以直接问列出我当前项目所有可用的 Skill6.3 通过关键词触发大多数 Skill 都有明确的触发关键词代码审查 → code-review 安全审计 → security-review 调试 → systematic-debugging 画图 → tensorart-generate SSH → ssh-agent掌握这些关键词你就能快速调用合适的 Skill。七、Skill 的典型使用模式7.1 单次调用模式请帮我审查这段代码 /code-review最基础的模式用完即走。7.2 组合调用模式先用 brainstorming 梳理需求 再用 writing-plans 制定实施计划 最后执行开发。多个 Skill 串联形成完整的工作流。7.3 循环调用模式/loop 10m 检查后端服务健康状态 /deploy-check ← deploy-check Skill 被激活配合loopSkill定期执行某个检查或任务。7.4 条件触发模式某些 Skill 只在特定条件下激活。例如verifySkill 在你准备提交代码前自动触发提醒你运行验证流程。八、这一章的核心心得Skill 是 Claude Code 的专业插件——每个 Skill 赋予 Claude 一项特定能力触发方式灵活——可以自然语言描述场景自动触发也可以用/命令手动调用内置 20 Skill——覆盖开发全流程开箱即用三级存储——内置不可改、项目级随项目走、用户级全局生效Skill 可以组合——多个 Skill 串联形成完整的自动化流程九、下一步认识了 Skill 系统的全貌知道了它能做什么。但内置的 Skill 不可能覆盖所有场景——你的项目有独特的规范、独特的流程、独特的工具链。下一篇我们将深入Skill 的内部构造学习如何从零开始编写一个属于自己的自定义 Skill。你会看到定义一个 Skill 只需要一个 Markdown 文件但它可以彻底改变 Claude 在你的项目中的工作方式。系列目录初识 Skill 系统——什么是 Skill为什么需要 Skill← 本篇自定义 Skill 开发——从 0 到 1 编写自己的 Skill待写Skill 编排与组合——多个 Skill 串联工作打造自动化流程待写实战 SkillDevOps 部署——编写 Docker/Nginx/CI-CD 相关的部署 Skill待写实战 Skill代码质量——编写 Code Review / Lint / 测试覆盖率 Skill待写实战 Skill文档生成——编写 API 文档 / 技术手册 / Changelog 生成 Skill待写Skill 分享与复用——团队共享 Skill 库、开源 Skill 生态、版本管理待写Skill 进阶技巧——条件触发、多语言支持、与 Agent/Workflow 的配合待写