Agent Mentor Learn
Claude Code Skills：打造你的专属 AI 工作流 · 第 6 / 6 节

第 6 课：进阶技巧：让 Skill 更强大

学习目标：

  • 理解 personal skills 和 project skills 的区别
  • 学会用 Git 管理 project skills
  • 掌握团队协作的最佳实践
  • 了解 Skills 生态系统

前置要求：<< 第 5 课

Personal Skills vs Project Skills

到目前为止，我们创建的 Skills 都放在 ~/.claude/skills/。这是 personal skills，只有你自己能用。1

但如果你在团队里工作，你可能希望：

  • 团队成员都用同样的代码审查标准
  • 新成员克隆代码后就能用团队的 Skills
  • Skills 的改进能自动同步给所有人

这时候需要 project skills。2

两者的区别

特性Personal SkillsProject Skills
位置~/.claude/skills/.claude/skills/
作用范围你的所有项目当前项目
版本控制不需要提交到 Git
团队共享不共享所有成员共享
典型用途个人习惯、通用工具项目规范、团队流程

什么时候用哪个

用 personal skills：2

  • 文档格式转换（Markdown → Word）
  • 个人的任务整理方式
  • 你自己的代码风格偏好
  • 跨项目的通用工具

用 project skills：

  • 团队的代码审查标准
  • 项目的 commit 消息格式
  • 特定框架的脚手架生成
  • 项目的部署流程

创建 Project Skills

第 1 步：在项目目录创建

进入你的项目目录：

<type>(<scope>): <subject>

<body> ```

Type 类型：

  • feat: 新功能
  • fix: 修复 bug
  • docs: 文档更新
  • style: 代码格式（不影响功能）
  • refactor: 重构
  • test: 测试相关
  • chore: 构建或工具变动

Scope 范围：

  • api: API 层
  • ui: 界面
  • db: 数据库
  • auth: 认证授权
  • core: 核心逻辑

处理步骤

  1. 分析原始 commit 内容，判断类型和范围
  2. 补充必要的上下文（为什么改、影响什么）
  3. 按格式输出

输出格式

<type>(<scope>): <subject>
<body>- 详细说明改动的原因- 影响的功能或模块- 相关的 issue 或 PR（如果有）

示例

输入： "修了那个登录的 bug"

输出：

fix(auth): 修复登录页面密码验证失败的问题
- 问题：密码包含特殊字符时验证失败- 原因：正则表达式未转义特殊字符- 影响：使用特殊字符密码的用户无法登录- 相关 issue: #123

EOF


### 第 2 步：提交到 Git
```bashgit add .claude/skills/commit-format/git commit -m "feat(tooling): 添加 commit 消息格式化 Skill"git push

第 3 步：团队成员获取

团队其他成员：

Skills 自动生效。不需要任何额外配置。1

用 Git 管理 Skills

既然 project skills 在 Git 里，就可以用 Git 的所有能力：3

版本控制

Code Review Skills 本身

是的，Skill 审查和代码审查一样重要。4

当团队成员提交一个新 Skill 或修改现有 Skill：

  1. 检查 description 是否清晰
  2. 检查 instructions 是否足够具体
  3. 测试是否真的按预期工作
  4. 评估是否值得加到项目里（会不会和现有 Skills 冲突）

在 PR 里审查 Skill 文件：

分支管理

分支实验：把实验性 Skill 放在 feature 分支里：

团队协作最佳实践

1. README 文档化

Skills 文档化的做法很简单：在项目根目录的 README 或 .claude/README.md 里列出所有 Skills：4

/commit-format 修了登录 bug


### code-review按团队标准审查代码变更。
**用法：** `/code-review` 然后粘贴代码或 diff
**注意：** 审查结果仅供参考，重要改动仍需人工复审

2. 统一命名约定

团队内部统一 Skill 的命名约定：3

推荐：

  • 用连字符：commit-format, api-doc-gen
  • 动词-名词或名词-动词：format-commit, review-code
  • 简短清晰：2-3 个词

避免：

  • 数字后缀：skill-1, helper-v2
  • 太泛化：tool, helper, utility
  • 项目缩写加数字：proj-skill-3

3. 定期清理

每个季度审查一次：3

用得少的 Skill，要么改进，要么删除。 太多不用的 Skill 会让 Claude 更难找到真正需要的那个。

4. 变更通知

重要： 修改现有 Skill 时，在团队频道通知：

📢 Skill 更新：code-review
改动：- 新增了对 React Hooks 规则的检查- 调整了函数长度阈值（50 行 → 40 行）
影响：- 之前通过的代码可能现在会被标记问题- 建议重新审查最近的 PR
如有疑问请联系 @张三

Skills 的组合使用

Skills 组合，就是把多个 Skills 串起来解决复杂任务：1

/commit-format 修了登录 bug
（Claude 输出格式化的 commit）
/code-review
（粘贴刚才改动的代码）

或者在一个 Skill 里引用另一个：

这就是 Skills 的强大之处：小的、单一职责的 Skills 可以组合成更复杂的工作流。5

超越基础：探索更多可能

你现在已经掌握了 Skills 的核心技能。接下来可以探索：

可选的 frontmatter 字段

本课程只讲了 name 和 description，还有更多字段：6

  • model：指定这个 Skill 用哪个模型（如果需要更强的推理能力）
  • allowed-tools：限制这个 Skill 只能用特定工具
  • disable-model-invocation：禁止 Claude 自动加载，只能手动调用

这三个字段里，model 决定用哪个模型，allowed-tools 圈定权限边界，disable-model-invocation 则关掉自动触发，只留手动调用。

什么时候用这些字段：

  • 代价高的操作（调用外部 API）→ 用 disable-model-invocation，避免误触发
  • 需要精确推理的任务 → 用 model: claude-opus-4
  • 安全敏感的 Skill → 用 allowed-tools 限制能做什么

在官方文档查看完整字段列表： https://code.claude.com/docs/en/skills[^S1]

Skills 与 MCP 服务器的结合

MCP (Model Context Protocol) 服务器提供工具，Skills 提供工作流知识。7

示例：

  • MCP 服务器提供 read_database 工具
  • Skill 教 Claude 如何用这个工具执行"生成月度报告"的工作流

两者配合，Skills 变成了连接 Claude 和外部系统的桥梁。7

社区 Skills

探索其他人创建的 Skills：

使用社区 Skill 的注意事项：

  • 先读完 SKILL.md，理解它做什么
  • 在测试项目里试用，不要直接用在生产代码上
  • 检查是否有安全风险（执行脚本、访问网络、修改文件）

小结

  • Personal skills (~/.claude/skills/) 用于个人习惯，project skills (.claude/skills/) 用于团队协作2
  • Project skills 提交到 Git，团队成员自动获取，用 Git 管理版本和分支
  • 团队协作最佳实践：文档化、统一命名、定期清理、变更通知
  • Skills 可以组合：小的单一职责 Skill 组合成复杂工作流5
  • 进阶方向：可选 frontmatter 字段、MCP 服务器集成、社区 Skills

恭喜你完成课程！

你现在已经掌握了：

  • ✅ Skills 的工作原理和应用场景
  • ✅ SKILL.md 的结构和编写方法
  • ✅ 测试和调试的系统化流程
  • ✅ 复杂 Skills 的组织方式
  • ✅ 团队协作的最佳实践

下一步：

  1. 马上创建一个 Skill：选择你这周重复解释过 3 次的任务，写成 Skill
  2. 实际使用一周：记录调用次数、发现的问题、节省的时间
  3. 迭代改进：根据实际使用反馈，补充遗漏的检查、调整输出格式
  4. 分享给团队：如果确实有用，把它变成 project skill

记住： 好的 Skill 不是一次写成的，是用出来的。3 4

祝你用 Skills 打造高效的 AI 工作流！

Footnotes

  1. Claude Code 官方文档：Skills 扩展指南 — https://code.claude.com/docs/en/skills ↩ ↩2 ↩3

  2. 教 Claude Code 你的工作流：自定义 Skills 实操指南 — https://medium.com/@n913239/teach-claude-code-your-workflow-a-hands-on-guide-to-custom-skills-8bc35d4a11ed ↩ ↩2 ↩3

  3. Claude Code Skills：.NET 工作流与可复用提示 — https://codewithmukesh.com/blog/skills-claude-code/ ↩ ↩2 ↩3 ↩4

  4. Claude Skills 作为自文档化的 Runbook — https://zackproser.com/blog/claude-skills-internal-training ↩ ↩2 ↩3

  5. Anthropic 工程博客：Agent Skills 实战指南 — https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills ↩ ↩2

  6. Claude Skills 深度解析（First Principles 视角） — https://leehanchung.github.io/blogs/2025/10/26/claude-skills-deep-dive/ ↩

  7. Claude Skills 创建完整指南（PDF） — https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf ↩ ↩2

练习

01

选择你当前的项目，创建一个 project skill：

Level 1：创建你的第一个 Project Skill
  1. 在项目目录创建 .claude/skills/[skill-name]/
  2. 编写一个与项目相关的 Skill（commit 格式、部署流程、测试生成等）
  3. 提交到 Git
  4. 在项目 README 里文档化这个 Skill
完成标准 · 本地勾选
02

假设团队成员提交了一个新 Skill 的 PR，写一份审查意见：

Level 2：审查一个 Skill PR

模拟 PR 内容：

写审查意见，指出至少 3 个问题。

完成标准 · 本地勾选