Claude Code 常用 Skill 完全指南

— 从入门到精通的实战手册 —

适用版本：Claude Code 2025-2026  |  编写日期：20260527

目录

一、什么是 Claude Code？

二、什么是 Skill？

三、Skill 的调用方式

四、核心技能详解

  4.1  brainstorming — 头脑风暴

  4.2  writing-plans — 编写计划

  4.3  executing-plans — 执行计划

  4.4  test-driven-development — 测试驱动开发

  4.5  systematic-debugging — 系统化调试

  4.6  code-review — 代码审查

  4.7  requesting-code-review — 请求代码审查

  4.8  receiving-code-review — 接收代码审查

  4.9  verification-before-completion — 完成前验证

  4.10 finishing-a-development-branch — 分支收尾

五、辅助工具类 Skill

六、Skill 优先级与组合使用

七、实战案例：完整开发流程演示

八、常见问题 FAQ

九、速查表

附录：进阶技巧

一、什么是 Claude Code？

Claude Code 是 Anthropic 推出的 AI 编程助手终端工具，直接运行在你的命令行中。与传统的代码补全工具不同，Claude Code 更像是一位「结对编程搭档」——你告诉它你想做什么，它会帮你分析代码、编写代码、运行测试、修复 Bug，甚至帮你管理 Git 工作流。

Claude Code 能做什么？

  • 编写和修改代码：根据需求生成新功能，重构现有代码

  • 调试和修复 Bug：系统化地定位问题并修复

  • 代码审查：像资深工程师一样审查代码质量

  • Git 操作：创建分支、提交代码、创建 PR

  • 运行和测试：启动应用、运行测试套件

  • 项目探索：理解大型代码库的结构和逻辑

Claude Code 的核心概念

工具（Tools）：内置工具如读文件、写文件、运行命令、搜索代码等，让 AI 能与项目交互。

Skill（技能）：预定义的工作流程指南，告诉 Claude Code 在特定场景下应该如何操作。

代理（Agents）：可以独立运行的子任务，支持多个代理并行处理不同任务。

钩子（Hooks）：在特定事件（如文件保存、工具调用）发生时自动执行的命令。

二、什么是 Skill？

Skill（技能）是 Claude Code 中预定义的一套工作流程指南。每个 Skill 都是一个独立的指令文件，告诉 Claude Code：

  • 在什么场景下应该使用这个 Skill

  • 使用这个 Skill 的完整步骤是什么

  • 应该遵循什么样的原则和约束

Skill 的两种类型

刚性（Rigid）：必须严格按照步骤执行，不能随意跳过或调整。例如：TDD（测试驱动开发）、调试、完成前验证、接收代码审查。

柔性（Flexible）：提供原则和指导，可以根据实际情况灵活调整。例如：头脑风暴、代码审查、代码简化。

 重要提示：Skill 会不断更新迭代，本文档基于 2025-2026 年版本。实际使用时请以当前版本为准。

三、Skill 的调用方式

方法一：使用 / 命令（推荐新手）

在 Claude Code 交互界面中，直接输入斜杠命令即可调用对应的 Skill：

/brainstorming

/debug

/review

/tdd

这是最简单、最直观的方式，适合日常使用。

方法二：使用 Skill 工具（高级用法）

Claude Code 提供了 Skill 工具，可以在对话中直接调用。通常由 Claude Code 自动触发，当它判断某个 Skill 可能适用时会自动建议或直接调用。

方法三：Claude 自动触发

Claude Code 会根据对话内容自动判断是否需要调用某个 Skill：

  • 当你提出一个新功能需求时，可能自动触发 brainstorming

  • 当你报告一个 Bug 时，可能自动触发 systematic-debugging

  • 当你完成一段代码时，可能自动触发 verification-before-completion

 小贴士：不需要记住所有 Skill 名称。直接用自然语言描述你想做什么，Claude Code 会自动选择合适的 Skill。如果明确想用某个 Skill，用 / 命令最快捷。

四、核心技能详解

4.1 brainstorming — 头脑风暴

这是你开始任何创造性工作的第一步。无论是添加新功能、构建新组件，还是修改现有行为，都应该先用头脑风暴来理清思路。

什么时候用？

  • 想添加一个新功能

  • 想修改某个模块的行为

  • 有一个想法但不确定怎么实现

  • 需要设计一个新的 API 接口

  • 想重构某段代码但不知从何入手

使用步骤

第 1 步：告诉 Claude Code 你的想法或需求。

第 2 步：Claude 会通过提问帮你理清需求（目标用户、核心场景、边界情况等）。

第 3 步：你回答后，Claude 会给出设计方案。

第 4 步：继续讨论、调整，直到方案满意。

使用示例

你：我想给用户个人页面添加一个「动态时间线」功能

Claude：[自动触发 brainstorming]

  → 这个时间线需要展示哪些类型的内容？

  → 用户可以对时间线做什么操作？

  → 数据从哪里来？实时的还是缓存的？

  → 需要支持无限滚动还是分页？

 最佳实践：头脑风暴阶段不要急着写代码。把需求和设计方案讨论清楚后再进入实现，可以避免大量返工。

4.2 writing-plans — 编写计划

当你有了明确的需求和设计方案后，使用这个 Skill 生成详细的实现计划。

什么时候用？

  • 头脑风暴结束，准备开始实现时

  • 你已经有了需求文档或设计方案

  • 想把一个大任务拆分成可执行的小步骤

计划包含什么？

  • 需要修改或创建的文件清单

  • 每个步骤的具体操作描述

  • 步骤之间的依赖关系和执行顺序

  • 可能的风险点和注意事项

使用示例

你：根据刚才讨论的方案，帮我写一个实现计划

Claude：[自动触发 writing-plans]

  → 步骤 1：修改 UserTimeline.vue，添加组件骨架

  → 步骤 2：在 api/timeline.js 中添加数据获取接口

  → 步骤 3：实现时间线列表的渲染逻辑

  → 步骤 4：添加无限滚动功能

  → 步骤 5：添加单元测试

 最佳实践：计划写好后仔细审查，确认步骤合理、没有遗漏。好的计划 = 好的实现。

4.3 executing-plans — 执行计划

有了计划后，这个 Skill 会按照计划一步步执行，并在关键节点让你审查和确认。

什么时候用？

  • 已经有了一份写好的实现计划

  • 想让 Claude 按照计划自动执行

  • 需要在独立的会话中执行计划（避免上下文混乱）

工作流程

第 1 步：Claude 读取你的计划。

第 2 步：按照步骤逐个执行。

第 3 步：每完成一个关键步骤，会暂停让你审查。

第 4 步：你确认无误后继续下一步。

第 5 步：所有步骤完成后，进行最终验证。

 注意事项：执行计划通常在新的会话或工作树中进行，以保证执行环境的干净。也可以同时让多个 Claude Code 实例并行执行不同计划。

4.4 test-driven-development — 测试驱动开发（TDD）

TDD 是一种严格的开发方法论：先写测试，再写代码，让测试来驱动开发。这是一个刚性 Skill，必须严格遵循。

TDD 核心流程（红-绿-重构）

红（Red）：先写一个会失败的测试。目的：明确定义期望的行为。

绿（Green）：写最少的代码让测试通过。目的：确保功能能正常工作。

重构（Refactor）：优化代码结构，保持测试通过。目的：保持代码整洁。

什么时候用？

  • 实现新功能时（特别是核心业务逻辑）

  • 修复 Bug 时（先写一个能复现 Bug 的测试）

  • 重构代码时（用测试保证行为不变）

使用示例

你：用 TDD 的方式实现一个用户注册功能

Claude：[自动触发 TDD]

  → 第 1 步：写测试用例，验证注册 API 能正确创建用户

  → 第 2 步：运行测试，确认它失败了（因为功还没实现）

  → 第 3 步：实现注册 API 的核心逻辑

  → 第 4 步：运行测试，确认测试通过

  → 第 5 步：重构代码，保持测试通过

 为什么推荐 TDD？：TDD 虽然看起来多了一步（先写测试），但它能帮你更清晰地思考需求，而且后续修改代码时，测试就是你的安全网——改坏了立刻就知道。

4.5 systematic-debugging — 系统化调试

当你遇到 Bug、测试失败或任何意外行为时，使用这个 Skill 系统化地定位和修复问题。

调试流程

第 1 步：复现问题——确认 Bug 可以稳定复现。

第 2 步：收集信息——查看错误日志、堆栈跟踪、相关代码。

第 3 步：形成假设——根据信息推测可能的原因。

第 4 步：验证假设——通过日志、断点等方式验证。

第 5 步：修复问题——找到根因后修复代码。

第 6 步：验证修复——确认 Bug 不再复现，且没有引入新问题。

关键原则

  • 先理解问题，再动手修复——不要盲目改代码

  • 一次只改一个地方，这样能确定是哪个改动修复了问题

  • 修复后一定要加测试，防止回归

使用示例

你：用户点击「提交」按钮后页面空白了

      控制台报错 'Cannot read property id of undefined'

Claude：[自动触发 systematic-debugging]

  → 让我先看看提交按钮的点击处理函数...

  → 发现了：函数中假设 user 对象一定存在，但未登录时 user 是 undefined

  → 修复：添加空值检查

  → 验证：运行相关测试，确认修复生效

4.6 code-review — 代码审查

让 Claude Code 像资深工程师一样审查你的代码，找出潜在的问题。

审查关注点

  • 正确性：逻辑是否正确？边界情况是否处理？

  • 安全性：是否存在 SQL 注入、XSS 等安全漏洞？

  • 性能：是否有不必要的重复计算？是否有 N+1 查询问题？

  • 可读性：变量命名是否清晰？代码结构是否易于理解？

  • 可维护性：是否遵循了项目的编码规范？

使用方式

/review              # 审查当前分支的所有改动

/review --fix        # 审查并自动修复发现的问题

/review --comment    # 将审查结果作为行内注释添加到代码中

审查力度级别

  • 低（low）：只检查高置信度的问题，输出精简

  • 中（medium）：覆盖更多面，仍以高置信度为主

  • 高（high-max）：更广泛的审查，可能包含不确定的发现

4.7 requesting-code-review — 请求代码审查

当你完成一个功能或修复后，用这个 Skill 向团队请求正式的代码审查（通常是创建 PR 并请求 Review）。

什么时候用？

  • 功能实现完成，准备提交 PR 时

  • 重大修改需要他人审阅时

  • 合并到主分支之前

工作流程

第 1 步：Claude 检查你的代码改动（git diff）。

第 2 步：自动生成 PR 标题和描述。

第 3 步：描述中包含改动摘要和测试计划。

第 4 步：帮你创建 PR 并推送到远程仓库。

4.8 receiving-code-review — 接收代码审查

当你收到代码审查反馈后，用这个 Skill 系统化地处理审查意见。这是一个刚性 Skill，强调技术严谨性。

核心原则

  • 先理解反馈，再动手修改——不要盲目同意每一个建议

  • 对不清楚的反馈先问清楚，再实施

  • 对技术上有疑问的反馈，先验证再决定是否采纳

  • 逐条处理审查意见，不要遗漏

处理流程

第 1 步：阅读所有审查意见。

第 2 步：对每条意见分类：同意 / 有疑问 / 不同意。

第 3 步：对有疑问的，先跟审查者沟通。

第 4 步：逐条实施修改。

第 5 步：修改完成后回复审查者。

 重要提醒：接收代码审查时，不要「表演性地同意」——如果你觉得某个建议不对，应该提出你的看法。好的代码审查是双向的技术讨论。

4.9 verification-before-completion — 完成前验证

在你声称任务完成、Bug 已修复、测试通过之前，必须先运行验证命令确认事实。这是刚性 Skill：证据优先于声明。

核心原则

  • 不要说「已经修复了」——先运行测试，看到测试通过再说

  • 不要说「功能正常」——先启动应用，实际操作一遍再说

  • 不要说「所有测试通过」——先运行完整测试套件，确认输出再说

什么时候用？

  • 声称某个 Bug 已修复时

  • 声称某个功能已实现时

  • 声称所有测试通过时

  • 提交代码或创建 PR 之前

使用示例

Claude：我已经修复了登录页面的空指钂异常。

你：请验证一下。

Claude：[自动触发 verification-before-completion]

  → 运行登录相关的测试套件...

  → 测试结果：8 passed, 0 failed

  → 启动应用，手动测试登录流程...

  → 确认：登录功能正常工作，空指钂异常不再出现

4.10 finishing-a-development-branch — 分支收尾

当你的开发工作全部完成、测试全部通过后，用这个 Skill 来决定如何整合你的代码。

收尾选项

  • 直接合并到主分支（适合小改动）

  • 创建 Pull Request（适合需要审查的改动）

  • 创建一个干净的提交（清理中间提交历史）

  • 清理临时文件和分支

工作流程

第 1 步：Claude 检查当前分支的状态。

第 2 步：确认没有未提交的改动。

第 3 步：确认所有测试通过。

第 4 步：你选择收尾方式。

第 5 步：Claude 帮你完成选定的操作。

五、辅助工具类 Skill

5.1 subagent-driven-development — 子代理驱动开发

当你的实现计划中有多个独立的任务时，Claude Code 可以启动多个子代理（Subagent）来并行执行，大大提高效率。

什么时候用？

  • 计划中有多个可以并行执行的任务

  • 想同时处理前端和后端的改动

  • 想让一个代理写代码，另一个代理同时写测试

工作原理

Claude Code 创建「主代理」协调整个工作，为每个独立任务创建「子代理」。子代理同时运行，各自完成自己的任务，最后主代理汇总结果。

 效率提示：这就像你一个人搬砖 vs 叫来几个朋友一起搬。每个朋友负责不同区域的砖，大大缩短了总时间。

5.2 dispatching-parallel-agents — 并行代理分发

当你面对 2 个以上可以独立完成的任务时，同时启动多个代理处理它们。

与 subagent-driven-development 的区别

  • subagent-driven-development：用于执行实现计划，子代理之间有协调

  • dispatching-parallel-agents：用于分发独立的查询或探索任务，代理完全独立

使用场景举例

你：同时帮我查三任事：

  1. 这个项目的数据库用的是什么 ORM？

  2. 前端用的什么状态管理库？

  3. CI/CD 配置在哪里？

Claude：[同时启动 3 个代理分别搜索]

5.3 using-git-worktrees — Git 工作树

Git 工作树让你可以在同一个仓库中同时检出多个分支，每个分支有自己的独立目录。这样可以在一个分支上开发的同时，在另一个分支上查看代码。

什么时候用？

  • 想在不影响当前工作的情况下探索另一个分支

  • 想同时在多个分支上并行开发

  • 想给执行计划一个干净的隔离环境

5.4 simplify — 代码简化

审查当前的代码改动，自动应用简化建议——删除冗余代码、简化逻辑、提高效率。

5.5 security-review — 安全审查

专门检查代码中的安全漏洞，包括：

  • SQL 注入风险

  • XSS（跨站脚本攻击）

  • 不安全的认证和授权

  • 敏感信息硬编码

  • 不安全的依赖库

5.6 run — 运行应用

启动并驱动你的应用程序，让你可以看到改动的实际效果。支持 CLI 应用、服务器、TUI、Electron 应用、浏览器驱动应用等。

什么时候用？

  • 要求 Claude 启动或运行应用时

  • 想确认某个改动在真实应用中是否生效时

  • 需要截图验证 UI 变化时

六、Skill 优先级与组合使用

优先级规则

当多个 Skill 可能适用时，遵循以下优先级：

1. 流程类 Skill 优先（头脑风暴、调试）—— 决定你如何做事

2. 实施类 Skill 其次（前端设计、API 构建）—— 指导具体执行

Skill 组合使用示例

  • 添加新功能：brainstorming → writing-plans → TDD → verification → requesting-code-review

  • 修复 Bug：systematic-debugging → TDD（先写复现测试）→ verification

  • 代码审查反馈：receiving-code-review → implementing → verification

  • 发布前检查：code-review → security-review → verification → finishing-branch

七、实战案例：完整开发流程演示

下面通过一个完整的案例，展示如何在实际开发中组合使用这些 Skill。

场景：为电商网站添加「商品收藏」功能

第 1 步：头脑风暴（brainstorming）

你：我想给商品详情页添加收藏功能

Claude：好的，让我先了解一下需求：

  1. 收藏后的商品在哪里展示？专门的「我的收藏」页面？

  2. 收藏有数量限制吗？

  3. 用户未登录时点击收藏怎么处理？

  4. 需要支持取消收藏吗？

你：1是的、2最多200个、3弹出登录弹窗、4需要

Claude：明白了。以下是设计方案...

第 2 步：编写计划（writing-plans）

Claude：

  步骤 1：创建 favorites 表的数据库迁移文件

  步骤 2：实现收藏 API（POST /api/favorites）

  步骤 3：实现取消收藏 API（DELETE /api/favorites/:id）

  步骤 4：实现收藏列表 API（GET /api/favorites）

  步骤 5：前端 - 商品详情页添加收藏按钮组件

  步骤 6：前端 - 创建「我的收藏」页面

  步骤 7：添加集成测试

第 3 步：执行计划（executing-plans + TDD）

Claude 按照计划逐个执行。每个步骤都先写测试，再实现功能。

  → 步骤 1：创建数据库迁移... 完成 ✓

  → 步骤 2：写 API 测试... 实现 API... 测试通过 ✓

  → ...（继续其他步骤）

第 4 步：验证（verification-before-completion）

  → 运行后端测试：42 passed, 0 failed ✓

  → 运行前端测试：18 passed, 0 failed ✓

  → 启动应用，手动测试收藏/取消收藏流程 ✓

第 5 步：代码审查（code-review）

Claude：审查完毕，发现 2 个问题：

  1. favorites API 缺少 rate limiting，可能导致恶意刷接口

  2. 收藏列表查询存在 N+1 问题，建议添加 eager loading

第 6 步：修复审查意见 → 提交 PR

  → 修复 rate limiting ✓

  → 优化查询性能 ✓

  → 重新验证，所有测试通过 ✓

  → 创建 PR：gh pr create --title '添加商品收藏功能'

八、常见问题 FAQ

问：我必须记住所有 Skill 的名称吗？

答：不需要。你可以用自然语言描述你想做什么，Claude Code 会自动选择合适的 Skill。明确想用某个 Skill 时，用 / 命令最快捷。

问：Skill 会自动更新吗？

答：是的。Claude Code 的 Skill 会随着版本更新而更新。你可以在 ~/.claude/skills/ 目录下查看和管理已安装的 Skill。

问：我可以创建自己的 Skill 吗？

答：可以。Claude Code 提供了 writing-skills 这个 Skill 来帮助你创建新的 Skill。自定义 Skill 非常适合团队内部的工作流程。

问：Skill 和工具有什么区别？

答：工具（Tools）是底层能力（读文件、写文件、运行命令）。Skill 更高层，是工作流程指南，告诉 Claude Code 在特定场景下如何组合使用这些工具。

问：为什么有些 Skill 是「刚性」的？

答：某些最佳实践（如 TDD、验证前断言）有其严格的理由。比如 TDD 的「先写测试」步骤看似多余，但它能帮你更早发现问题。这些 Skill 的严格性是经过实践验证的。

问：多个 Skill 可以同时使用吗？

答：Skill 是按顺序触发的，但可以组合使用。比如先 brainstorming 确定方案，再 writing-plans 制定计划，再 executing-plans 执行。dispatching-parallel-agents 可以同时启动多个代理并行工作。

九、速查表

以下是日常使用中可以快速参考的速查表。

brainstorming

使用场景：新功能设计、需求探索  |  类型：柔性

writing-plans

使用场景：制定实现计划  |  类型：柔性

executing-plans

使用场景：按计划执行  |  类型：柔性

test-driven-development

使用场景：先写测试再写代码  |  类型：刚性

systematic-debugging

使用场景：定位和修复 Bug  |  类型：刚性

code-review

使用场景：审查代码质量  |  类型：柔性

requesting-code-review

使用场景：创建 PR 请求审查  |  类型：柔性

receiving-code-review

使用场景：处理代码审查反馈  |  类型：刚性

verification-before-completion

使用场景：完成前验证  |  类型：刚性

finishing-a-development-branch

使用场景：分支收尾合并  |  类型：柔性

subagent-driven-development

使用场景：并行执行计划任务  |  类型：柔性

dispatching-parallel-agents

使用场景：并行处理独立任务  |  类型：柔性

using-git-worktrees

使用场景：隔离开发环境  |  类型：柔性

simplify

使用场景：简化代码  |  类型：柔性

security-review

使用场景：检查安全漏洞  |  类型：柔性

run

使用场景：启动并测试应用  |  类型：柔性

注：部分 Skill 的斜杠命令可能因版本不同而有所变化。如果 / 命令不生效，用自然语言描述需求即可，Claude Code 会自动匹配合适的 Skill。

附录：进阶技巧

技巧 1：利用工作树并行开发

当你需要同时开发多个功能时，可以使用 Git 工作树让每个功能在独立的分支和目录中开发，互不干扰。Claude Code 可以帮你自动创建和管理工作树。

技巧 2：善用 CLAUDE.md 文件

在项目根目录创建 CLAUDE.md 文件，写下项目规范和偏好。Claude Code 每次启动时都会读取这个文件。例如：

# 项目规范

- 使用 TypeScript 严格模式

- 测试使用 Jest 框架

- 提交信息使用 Conventional Commits 格式

- 代码风格遵循 ESLint 配置

技巧 3：用子代理处理耗时任务

如果某个任务比较耗时（比如搜索整个代码库、运行完整测试套件），可以让 Claude Code 用子代理在后台处理，你继续做其他事情。

技巧 4：结合 Memory 系统

Claude Code 有一个持久化记忆系统。它会记住你的偏好、项目上下文和过去的决策，这样在后续对话中就不需要重复说明。可以通过 /remember 命令让 Claude 记住特定信息。

— 全文完 —