在最近的使用中，我发现 Skill 机制可以说是 Claude Code 最强大的扩展能力之一。它不仅仅是一个简单的命令快捷方式，而是真正让 AI 从一个"工具"变成了一个可以深度定制的"伙伴"。通过 Skill，你可以把特定的领域知识、工作流程、甚至思维模式都封装进去，让 AI 在特定场景下表现得更专业、更精准。
这篇文章我会先带大家深入理解 Skill 机制到底是什么，然后手把手教大家如何创建一个真正可用的 Skill。准备好了吗？走起！
2.1 什么是 Skill
2.2 Skill 的触发方式
Skill 的触发方式很灵活，主要有以下几种：
- 命令：输入 /skill-name 即可触发，比如 /blog-writing
- 自然语言触发：当你的请求命中了某个 Skill 的描述时，AI 会自动加载
- 工具调用触发：通过 Skill 工具直接调用
2.3 Skill 的标准结构
根据官方规范，一个完整的 Skill 目录结构是这样的：
my-skill/ ├── SKILL.md # 主要说明（必需） ├── template.md # Claude 要填写的模板 ├── examples/ │ └── sample.md # 示例输出 ├── scripts/ │ └── validate.sh # 可执行的脚本 └── assets/└── logo.png # 静态资源
2.4 Skill 与普通对话的区别
可能有同学会想：这不就是预设一些提示词吗？区别可大了！
3.1 创建目录结构
首先，在 .claude/skills/ 目录下创建你的 skill 目录。比如我们要创建一个“代码审查”Skill：
.claude/skills/code-review/ ├── SKILL.md ├── examples/ │ └── sample-report.md └── scripts/└── check-security.sh
3.2 编写 SKILL.md
SKILL.md 是核心文件，需要包含 YAML frontmatter 和 markdown 内容。
— name: code-review description: 代码审查助手，帮助发现代码问题、改进建议和安全漏洞。使用场景：代码审查、**实践检查、安全漏洞检测。 disable-model-invocation: falseallowed-tools: Read, Grep, Glob
Code Review Skill
审查流程
- 理解代码：先完整阅读代码，理解其逻辑和意图
- 逐层分析：从安全性、性能、可维护性、代码风格等维度逐一检查
- 输出报告：提供结构化的审查报告，包含问题描述、严重程度和修复建议
输出格式
问题列表
- [严重程度] 问题描述
- 文件位置
- 原因分析
- 修复建议
3.3 参数传递
Skill 支持动态参数，使用 \(ARGUMENTS 占位符：
修复 GitHub issue \)ARGUMENTS，按照我们的代码规范执行。
- \(ARGUMENTS - 调用时传递的所有参数
- \)ARGUMENTS[N] 或 \(N - 按索引访问单个参数
- \){CLAUDE_SESSION_ID} - 当前会话 ID
- \({CLAUDE_SKILL_DIR} - Skill 文件所在目录
示例：运行 /migrate-component SearchBar React Vue，则 0=SearchBar,1=React, \)
2=Vue
3.4 添加示例文件
在 examples 目录添加示例，让 Claude 知道期望的输出格式：
# 代码审查报告示例
问题列表
- [严重] SQL 注入风险
- 文件: src/user/login.js:45
- 原因: 直接拼接用户输入到 SQL 查询
- 建议: 使用参数化查询
评分
- 安全性: 6⁄10
- 性能: 8⁄10
- 可维护性: 7⁄10
3.5 添加脚本
在 scripts 目录添加可执行脚本：
#!/bin/bash代码安全检查脚本
echo “Running security checks…”
这里可以添加静态代码分析工具
3.6 测试
帮我审查一下这段代码有什么问题
Skill 还有不少进阶用法，更多细节可以参考官方文档：https://code.claude.com/docs/zh-CN/skills
4.1 动态上下文注入
使用 !command" 语法在 skill 加载前执行命令，结果直接注入到提示中。适合需要实时获取外部数据的场景。
4.2 在 subagent 中运行
通过设置 context: fork，让 skill 在隔离的 subagent 上下文中运行，适合复杂任务。
4.3 生成视觉输出
Skill 可以运行脚本生成交互式 HTML，实现代码库可视化、测试报告等功能。
4.4 Hooks 集成
可以限定 skill 生命周期内的 hooks，实现更精细的自动化。
5.1 命名规范
建议使用小写字母加横线：blog-writing、code-review
5.2 触发词优化
description 部分尽量覆盖用户可能的表达方式。以 code-review 为例：
description: 代码审查助手，帮助发现代码问题、改进建议和安全漏洞。使用场景：代码审查、**实践检查、安全漏洞检测、帮我看看代码有什么问题
5.3 链式 Skill
多个 Skill 组合使用：先代码审查，再写成博客。
今天我们深入探讨了 Claude Code 的 Skill 机制，从概念到实战，总算是把这个强大的功能给讲透了。
Skill 机制的核心价值在于：它让 AI 不仅仅是回答问题，而是能够理解你的工作场景，按照你的方式来工作。一个好的 Skill，就像一个经验丰富的同事，熟悉你的习惯，了解你的标准。
感谢各位看官的一路陪伴，大家都再接再厉！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/283104.html