Claude Code Skills 技能配置完全指南
本文详细介绍了为Claude Code配置自定义Skills的方法，包含三个实用技能配置指南：1)博客写作技能规范技术文章写作流程；2)代码审查技能标准化Code Review流程；3)Git提交技能统一中文Commit格式。通过创建.claude/skills/目录并添加Markdown格式的技能文件，可使Claude在特定场景下自动遵循预设规范，提升开发效率。文章还提供了技能命名、触发条件设计
Claude Code Skills 技能配置完全指南
摘要
本文详细介绍如何为 Claude Code 配置自定义 Skills（技能），包括博客写作、代码审查和 Git 提交规范三个实用技能的创建过程。通过配置 Skills，可以让 Claude Code 在特定场景下自动遵循预设的工作流程和规范，大幅提升开发效率。
背景知识
Claude Code 是什么？
Claude Code 是 Anthropic 官方推出的命令行工具，基于 Claude 大语言模型，专门用于辅助软件工程任务。它可以帮助开发者：
- 编写和修改代码
- 调试和修复 Bug
- 生成文档和测试
- 执行 Git 操作
- 解释代码逻辑
Claude Code 扩展体系
Claude Code 提供三种扩展机制：
| 扩展类型 | 用途 | 配置位置 |
|---|---|---|
| MCP Servers | 连接外部工具和 API | settings.json |
| Skills | 定义工作流程和领域知识 | .claude/skills/ |
| Hooks | 自动响应特定事件 | settings.json |
本文重点介绍 Skills 的配置方法。
Skills 技能配置
什么是 Skills？
Skills（技能）是通过 Markdown 文件定义的指令集，告诉 Claude Code 在特定场景下应该如何工作。当用户的请求匹配技能的触发条件时，Claude 会自动参考技能文件中的规范来执行任务。
目录结构
项目目录/
├── .claude/
│ ├── settings.local.json # 本地配置
│ └── skills/ # 技能目录
│ ├── blog-writer.md # 博客写作技能
│ ├── code-review.md # 代码审查技能
│ └── git-commit.md # Git 提交技能
创建 Skills 目录
mkdir -p .claude/skills
技能一：博客写作技能
创建文件
创建 .claude/skills/blog-writer.md：
# Blog Writer Skill / 博客写作技能
当用户要求写博客、技术文章或教程时，使用此技能。
## 触发条件
- 用户提到"写博客"、"写文章"、"技术博客"、"教程"
- 用户要求解释技术概念并生成文档
- 用户需要为项目创建说明文档
## 写作流程
### 1. 确认主题和受众
- 确认博客主题和技术深度
- 了解目标读者（初学者/中级/高级）
- 确定文章长度和风格
### 2. 文章结构模板
# [标题]
## 摘要/导言
简要介绍主题，说明读者将学到什么
## 背景知识（可选）
读者需要了解的前置知识
## 核心内容
### 概念解释
### 实践示例
### 进阶内容（可选）
## 常见问题/注意事项
## 总结
## 写作规范
### 语言风格
- 使用清晰、简洁的语言
- 使用中文写作，代码和技术术语保留英文
### 代码示例
- 提供完整、可运行的代码
- 添加必要的注释
### 格式要求
- 使用清晰的标题层级（# ## ###）
- 适当使用列表、表格、代码块
使用方法
"帮我写一篇关于 Docker 的技术博客"
"写一个 Python 入门教程"
"为这个项目创建 README 文档"
技能二：代码审查技能
创建文件
创建 .claude/skills/code-review.md：
# Code Review Skill / 代码审查技能
当用户要求审查代码或进行 Code Review 时，使用此技能。
## 触发条件
- 用户提到"代码审查"、"code review"、"检查代码"
- 用户提交 PR 或 MR 需要审查
## 审查维度
### 安全性 (Security)
- SQL 注入风险
- XSS 跨站脚本攻击
- 敏感信息泄露
### 性能 (Performance)
- 不必要的循环
- N+1 查询问题
- 内存泄漏风险
### 可读性 (Readability)
- 命名是否清晰
- 函数长度是否合理
- 复杂逻辑是否有注释
### 错误处理 (Error Handling)
- 异常捕获是否完整
- 边界条件是否处理
## 输出格式
### 审查报告模板
# 代码审查报告
## 概述
- **文件/模块**: [文件名]
- **整体评价**: [优秀/良好/需改进]
## 发现的问题
### 🔴 严重 (Must Fix)
| 位置 | 问题描述 | 建议修复 |
### 🟡 建议 (Should Fix)
| 位置 | 问题描述 | 建议修复 |
### 🟢 可选 (Nice to Have)
| 位置 | 问题描述 | 建议修复 |
## 严重程度定义
| 级别 | 定义 | 处理方式 |
|------|------|----------|
| 🔴 严重 | 安全漏洞、严重 bug | 必须修复 |
| 🟡 建议 | 性能问题、代码规范 | 强烈建议修复 |
| 🟢 可选 | 代码风格、微小优化 | 可选择性修复 |
使用方法
"帮我审查这段代码"
"检查这个文件的安全问题"
"review 一下这个 PR"
技能三：Git 提交技能（中文版）
创建文件
创建 .claude/skills/git-commit.md：
# Git Commit Skill / Git 提交技能
当用户要求提交代码或写 commit message 时，使用此技能。
## Commit Message 规范
### 格式
<type>(<scope>): <subject>
<body>
<footer>
### Type 类型
| 类型 | 说明 | Emoji |
|------|------|-------|
| `feat` | 新功能 | ✨ |
| `fix` | Bug 修复 | 🐛 |
| `docs` | 文档更新 | 📝 |
| `style` | 代码格式 | 💄 |
| `refactor` | 重构 | ♻️ |
| `perf` | 性能优化 | ⚡ |
| `test` | 测试 | ✅ |
| `chore` | 其他修改 | 🔧 |
### Subject 标题
- **默认使用简体中文**
- 不超过 50 个字符
- 使用祈使句（动词开头）
- Type 和 Scope 保留英文，描述用中文
## 示例
### 简单提交
feat(auth): 添加用户登录功能
### 带正文的提交
fix(api): 修复支付服务超时问题
支付 API 由于同步数据库调用导致 30 秒后超时。
已改为异步操作并将超时时间增加到 60 秒。
Fixes #234
### Breaking Change
refactor(api)!: 修改用户接口返回格式
BREAKING CHANGE: 用户接口现在返回嵌套对象而非扁平结构。
使用方法
"帮我提交代码"
"生成 commit message"
"提交这些变更"
权限配置（可选）
如果需要在 settings.local.json 中配置技能权限：
{
"permissions": {
"allow": [
"Skill(blog-writer)",
"Skill(code-review)",
"Skill(git-commit)"
]
}
}
最佳实践
1. 技能文件命名
- 使用小写字母和连字符
- 名称应简洁明了
- 例如：
blog-writer.md、code-review.md
2. 触发条件设计
- 列出所有可能的触发关键词
- 同时支持中英文触发
- 避免与其他技能冲突
3. 输出格式规范
- 提供清晰的模板
- 使用表格整理结构化信息
- 包含实际示例
4. 持续迭代
- 根据使用反馈优化技能
- 添加新的场景和规范
- 保持文档更新
常见问题
Q: Skills 和 MCP Servers 有什么区别？
| 特性 | Skills | MCP Servers |
|---|---|---|
| 用途 | 定义工作流程 | 连接外部工具 |
| 格式 | Markdown | JSON 配置 |
| 触发 | 自动识别 | 显式调用 |
| 复杂度 | 简单 | 较复杂 |
Q: 如何调试 Skills？
- 检查文件路径是否正确（
.claude/skills/） - 确认 Markdown 格式无语法错误
- 测试触发条件是否生效
- 查看 Claude 的响应是否符合预期
Q: 可以创建多少个 Skills？
没有数量限制，但建议：
- 保持技能职责单一
- 避免技能之间功能重叠
- 定期清理不再使用的技能
总结
通过本文，我们学习了：
- Claude Code 扩展体系：了解 MCP、Skills、Hooks 三种扩展机制
- Skills 配置方法：创建
.claude/skills/目录并添加 Markdown 文件 - 三个实用技能：
- 博客写作技能：规范化技术文章写作流程
- 代码审查技能：标准化 Code Review 流程
- Git 提交技能：统一中文 Commit Message 格式
配置好这些技能后，Claude Code 将在相应场景下自动遵循预设规范，让开发工作更加高效和一致。
参考资源
小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用
更多推荐
41
0- 0
已为社区贡献22条内容
所有评论(0)