skills 是什么

你可以把 skill 理解成：

• 一个带 frontmatter 的 SKILL.md
• 可附带脚本、模板、参考资料
• 会被 Claude 自动发现和按需加载
• 更适合长期复用的工作流能力

和普通 prompt 相比，skills 更稳定、更易复用，也更适合团队共享。

---

skills 和 slash commands 的区别

更适合用 skill 的情况

• 你希望 Claude 自动判断什么时候该触发
• 你需要附带模板、脚本、参考资料
• 这是一个长期工作流，而不是一次性快捷命令

更适合用 slash command 的情况

• 你希望自己手动明确触发
• 它更像一个短促的操作入口
• 你希望用户一眼知道“我要输入哪个命令”

---

一个 skill 的基本结构

skill-name/
├── SKILL.md
├── templates/
├── scripts/
└── references/

SKILL.md 负责什么

• 定义 skill 名称
• 说明 skill 在什么情况下应该触发
• 告诉 Claude 该怎么做

其他目录负责什么

• templates/：输出模板
• scripts/：辅助脚本
• references/：参考规则或背景知识

---

skills 放哪里

类型	路径	适合什么
个人级	~/.claude/skills/<skill-name>/SKILL.md	个人工作流
项目级	.claude/skills/<skill-name>/SKILL.md	团队共享
plugin 自带	<plugin>/skills/...	和 plugin 一起分发

当 skills 在各个级别共享相同的名称时，企业覆盖个人，个人覆盖项目。插件 skills 使用 plugin-name:skill-name 命名空间，因此它们不能与其他级别冲突。如果你在 .claude/commands/ 中有文件，它们的工作方式相同，但如果 skill 和命令共享相同的名称，skill 优先。

---

如何安装

安装到个人目录

mkdir -p ~/.claude/skills
cp -r code-review ~/.claude/skills/

安装到项目目录

mkdir -p .claude/skills
cp -r code-review .claude/skills/

---

SKILL.md

---
name: code-review-specialist
description: 综合代码审查 skill，覆盖安全、性能、代码质量和可维护性。Use when users ask to review code, analyze code quality, evaluate pull requests, or mention code review, security analysis, or performance optimization.
---

# 代码审查技能（Code Review Skill）

这个 skill 用于做结构化代码审查，重点关注：

1. **Security Analysis**
2. **Performance Review**
3. **Code Quality**
4. **Maintainability**

## 审查模板

## 参考文件

这个 skill 自带模板和脚本，做正式审查时应按需读取：

- `templates/review-checklist.md`：结构化检查清单，覆盖安全、性能、质量和测试，避免漏掉大类。
- `templates/finding-template.md`：单个问题的记录模板，包含严重程度、位置、代码示例和影响分析。
- `scripts/analyze-metrics.py`：统计函数数、类数、平均行长和复杂度分数，可用于给审查补充量化依据。
- `scripts/compare-complexity.py`：对比两个版本的复杂度，适合审查重构前后的变化。

### 总结

- Overall quality assessment
- Key findings count
- Recommended priority areas

### 严重问题

- **Issue**
- **Location**
- **Impact**
- **Severity**
- **Fix**

### 按类别列出问题

#### 安全

列出安全漏洞或风险点

#### 性能

列出性能问题与复杂度风险

#### 质量

列出命名、结构、文档和测试问题

#### 可维护性

列出可维护性问题和重构建议

测试 skill

/code-review-specialist