如何打造属于自己的 Skills

your-project/
└── .claude/
    └── skills/
        └── my-first-skill/    ← 技能文件夹
            └── SKILL.md       ← 核心指令文件（必须）

---
name:code-review
description:对代码进行全面审查，包含安全性和质量检查
allowed-tools:ReadGrepGlobBash(git*)
---

# 代码审查清单

## 安全审查
-检查SQL注入漏洞
-验证输入数据的合法性
-确保输出编码安全
-审查认证和授权逻辑

## 代码质量
-检查代码重复
-验证命名规范一致性
-确保适当的错误处理
-审查关键区域的测试覆盖

## 性能
-寻找低效算法
-检查不必要的数据库查询
-验证缓存策略是否合理

请给出具体的改进建议，包含文件位置和行号。

/code-review

---
name:deploy
description:部署应用到指定环境
disable-model-invocation:true
allowed-tools:Bash(npm*)Bash(git*)Bash(docker*)
---
部署$ARGUMENTS到生产环境：

1.运行测试：`npmtest`
2.构建项目：`npmrunbuild`
3.更新版本：`npmversionpatch`
4.推送镜像：`dockerpush$0`
5.部署上线：`kubectlapply-fk8s/deployment.yaml`

code-review/
├── SKILL.md              ← 主入口（保持精简）
├── security-checklist.md ← 安全审查细则
├── style-guide.md        ← 代码风格指南
└── examples/
    └── good-review.md    ← 审查报告样例

详细安全检查项请参考 [security-checklist.md](security-checklist.md)
代码风格要求请参考 [style-guide.md](style-guide.md)

## 当前 PR 上下文
- PR 差异：!`gh pr diff`
- PR 评论：!`gh pr view --comments`
- 变更文件：!`gh pr diff --name-only`

---
name:explain
description:用通俗语言和类比解释代码的工作原理
---
解释代码时请遵循以下规则：

1.**先打比方**：把代码比作生活中的事物（如：这个函数像一个快递分拣中心）
2.**画流程图**：用ASCII艺术展示数据流向和调用关系
3.**逐行讲解**：逐步说明每一行的作用
4.**指出陷阱**：标出容易踩坑的地方

保持口语化风格。复杂概念使用多个类比。

---
name:commit
description:智能生成Git提交信息并执行提交
allowed-tools:Bash(git*)
disable-model-invocation:true
---
分析当前暂存区的变更，生成规范的提交信息并提交：

1.运行`gitdiff--cached`查看暂存的变更
2.分析变更内容，生成简洁的提交信息
3.提交信息格式：`<type>:<描述>`
   -type可选：feat/fix/refactor/docs/style/test/chore
4.确认后执行`gitcommit`

如果暂存区为空，提示用户先`gitadd`。

---
name:gen-docs
description:从源代码生成API文档
context:fork
allowed-tools:ReadGrepGlobBash
---
为$ARGUMENTS目录下的源代码生成API文档：

1.扫描指定目录的所有源文件
2.提取公开的API、类、方法和属性
3.生成结构化的Markdown文档
4.包含使用示例和参数说明
5.输出到`docs/api/`目录

---
name:health-check
description:全面检查项目健康状况，输出诊断报告
allowed-tools:ReadGrepGlobBash
---
对当前项目进行全方位健康检查：

## 代码质量
-检查代码重复率
-分析函数复杂度
-检查依赖是否过时

## 安全性
-扫描已知漏洞
-检查敏感信息泄露
-验证依赖安全性

## 测试覆盖
-分析测试覆盖率
-识别未覆盖的关键路径

## 性能
-检查打包体积
-分析启动时间

最终输出一份带有优先级排序的改进建议清单。

1  创建目录    →    mkdir -p .claude/skills/my-skill
2  编写指令    →    编写 SKILL.md（frontmatter + 指令正文）
3  立即使用    →    在 Claude Code 中输入 /my-skill