纯技术分享，无付费内容，所有 Skills 开源可用
一、痛点：为什么你需要中文 Skills？
如果你用过 Claude Code，一定遇到过这些场景：
-
想用英文 Skill 但提示词太长，复制粘贴容易出错
-
自己写中文提示词，但效果远不如官方英文 Skill
-
每次都要重复描述任务背景，浪费大量 token
-
复杂任务（如代码审查、API 设计）需要反复调试提示词
根本原因：Claude Code 的 Skills 机制本质上是一套预优化的提示词模板，官方 Skills 经过大量迭代，在任务拆解、输出格式、边界条件处理上都远优于临时编写的提示词。
但英文 Skills 对中文用户有三个硬伤：
-
认知负荷高：需要在中文思维和英文提示词之间切换
-
修改困难：想调整输出格式或增加约束条件时，英文提示词难以精准修改
-
协作障碍：团队内部分享时，中文成员理解成本高
解决方案：将高频 Skills 中文化，并打包成可复用的技能库。
二、什么是 Claude Code Skills？
核心概念
Skills 是 Claude Code 的任务模板系统，位于 ~/.claude/commands/ 目录下。每个 Skill 是一个 .md 文件，包含：
# skill-name
## 触发方式
/技能名 [参数]
## 任务描述
清晰定义这个技能做什么
## 输出格式
结构化定义输出内容
## 约束条件
边界情况处理、禁止行为等
工作原理
-
用户在终端输入
/skill-name 参数 -
Claude Code 加载对应 Skill 文件
-
将用户参数注入模板
-
执行优化后的完整提示词
本质：Skills = 预编译的提示词，避免每次重复编写。
三、20 个中文 Skills 分类介绍
基础技能（10 个）
| 技能名 | 功能 | 使用场景 |
|--------|------|----------|
| /code-review | 代码审查 | PR 提交前检查代码质量 |
| /unit-test | 生成单元测试 | 为新函数快速编写测试用例 |
| /doc-gen | 文档生成 | 自动生成函数/类的文档字符串 |
| /refactor | 代码重构 | 优化代码结构，提升可读性 |
| /bug-fix | 故障排查 | 根据错误信息定位并修复 bug |
| /git-commit | 提交信息生成 | 根据 diff 生成规范的 commit message |
| /explain | 代码解释 | 向新手解释复杂代码逻辑 |
| /security-check | 安全检查 | 扫描常见安全漏洞（SQL 注入、XSS 等） |
| /performance | 性能分析 | 识别性能瓶颈并给出优化建议 |
| /dependency | 依赖管理 | 分析 package.json/requirements.txt 给出升级建议 |
专业技能（10 个）
| 技能名 | 功能 | 使用场景 |
|--------|------|----------|
| /api-design | API 设计规范 | 设计 RESTful/GraphQL API 接口 |
| /db-optimize | 数据库优化 | SQL 查询优化、索引建议 |
| /dockerfile | Docker 镜像构建 | 生成优化的 Dockerfile |
| /ci-cd | CI/CD 配置 | 生成 GitHub Actions/GitLab CI 配置 |
| /terraform | 基础设施代码 | 生成 Terraform 资源定义 |
| /graphql-schema | GraphQL 模式设计 | 设计类型系统和解析器 |
| /microservice | 微服务架构 | 服务拆分建议和通信方案设计 |
| /cache-strategy | 缓存策略 | Redis/Memcached 缓存方案设计 |
| /logging | 日志规范 | 统一日志格式和级别定义 |
| /migration | 数据迁移 | 数据库迁移脚本生成 |
四、使用教程：如何加载和使用 Skills
步骤 1：下载 Skills 包
# 克隆 Skills 仓库到本地
git clone https://github.com/your-repo/claude-code-skills-cn.git
# 复制到 Claude Code 技能目录
cp -r claude-code-skills-cn/* ~/.claude/commands/
步骤 2：验证安装
# 进入任意项目目录
**cd** your-project
# 列出可用 Skills
claude -l
# 应该能看到中文 Skills 列表
步骤 3：使用示例
示例 1：代码审查
claude /code-review src/auth/login.ts
输出：
## 代码审查报告
### ✅ 优点
- 输入验证完整
- 错误处理清晰
### ⚠️ 改进建议
1. 第 15 行：密码哈希应使用 bcrypt 而非 md5
2. 第 23 行：缺少速率限制，建议添加 throttle 中间件
3. 第 31 行：日志不应记录明文密码
### 🔒 安全问题
- 高风险：明文密码日志（CVE-2023-XXXX）
示例 2：生成单元测试
claude /unit-**test** src/utils/format.ts --coverage
示例 3：API 设计
claude /api-design "用户管理系统" --rest --auth jwt
五、效果对比：使用 Skills 前后的效率提升
测试场景：为新 API 端点编写完整实现
| 指标 | 无 Skills | 使用 Skills | 提升 |
|------|-----------|-------------|------|
| 提示词编写时间 | 15 分钟 | 30 秒 | 30 倍 |
| 首轮输出可用性 | 60% | 90% | **50% ** |
| 迭代轮次 | 4-5 轮 | 1-2 轮 | **60% ** |
| Token 消耗 | ~2000 | ~800 | **60% ** |
| 总耗时 | 45 分钟 | 8 分钟 | 5.6 倍 |
质量对比
无 Skills 时常见问题：
-
输出格式不统一，需要手动整理
-
遗漏边界条件处理
-
安全考虑不足
-
文档缺失或不规范
使用 Skills 后：
-
输出结构一致，便于自动化处理
-
内置最佳实践检查清单
-
安全/性能/可维护性全覆盖
-
文档自动生成
六、扩展建议：如何自定义 Skills
场景 1：适配团队规范
# /code-review-team
## 基于官方 code-review 修改
### 额外约束
- 必须检查是否符合团队 ESLint 配置
- 必须验证错误码是否符合错误码规范 v2.3
- 输出必须包含 JIRA 任务关联建议
场景 2：增加领域知识
# /api-design-fintech
## 在通用 API 设计基础上增加
### 金融行业特殊要求
- 所有金额字段必须使用 decimal 类型
- 必须包含幂等性设计
- 必须记录审计日志
- 符合 PCI-DSS 合规要求
场景 3：集成内部工具
# /deploy-internal
## 调用内部部署系统
### 步骤
1. 生成 Kubernetes 部署 YAML
2. 调用内部 API 注册服务
3. 配置监控告警规则
4. 生成部署检查清单
最佳实践
-
命名规范：使用小写字母 + 连字符，如
api-design -
参数设计：使用
--flag格式，便于 shell 解析 -
输出格式：优先使用 Markdown，便于阅读和解析
-
版本管理：Skills 文件应纳入 Git 版本控制
-
文档化：每个 Skill 应有使用示例和输出样例
七、获取方式
所有 20 个中文 Skills 已开源：
-
GitHub 仓库：搜索
claude-code-skills-cn -
许可证：MIT（可商用、可修改）
-
更新频率：每月更新，根据社区反馈迭代
结语
Skills 是 Claude Code 被低估的效率工具。通过中文化和本地化，可以将重复性提示词编写工作转化为一次投入、长期复用的资产。
建议行动：
-
从 20 个 Skills 中选择 3-5 个高频使用的开始
-
在实际项目中试用并记录效果
-
根据团队需求自定义扩展
-
将 Skills 纳入团队开发规范
效率提升不是来自更好的 AI，而是来自更好的提示词工程。Skills 就是提示词工程的工业化解决方案。
