一、为什么需要自定义 Skill？

Superpowers 使用一段时间后，一些重复性工作模式会逐渐浮现出来：

• 某些工作流程反复出现，每次都得手动描述一遍，效率低下
• 团队内部有特定的代码规范，内置 Skills 总差那么点意思，无法完全匹配
• 希望把日常积累的开发经验"固化"成随时可调用的标准化流程
• 公司有自己的私有框架，需要一套量身定制的开发 Skill

举个例子：

每次做代码审查（Code Review），你都得重复一套固定的话术：

重复次数多了，真的会感到厌烦。假设有这么一条命令，/superpowers.code-review，敲一下，审查流程自动跑完，效率提升可不是一星半点。

这其实就是自定义 Skill 的核心价值——把你脑子里的经验，变成一个可复用的"技能包"。

二、Superpowers Skill 结构解析

动手之前，我们先来看看一个标准的 Superpowers Skill 到底长什么样。

2.1 目录结构

skills/
└── code-review/
    ├── SKILL.md           # Skill 描述文件（必需）
    ├── prompt.md          # 主提示词文件（必需）
    ├── examples/             # 示例目录（可选）
    │   └── sample-review.md
    └── references/           # 参考文件（可选）
        └── company-style-guide.md

2.2 SKILL.md —— Skill 的"身份证"

---
name: code-review
description: 代码审查 Skill，自动审查代码的安全性、性能和可维护性，输出 Markdown 报告。
---

# Code Review Skill

这个 Skill 用于自动化代码审查流程...

## 使用方式

> /superpowers.code-review <文件路径或代码块>

关键点很明确：

• name：Skill 的唯一标识符，决定了你调用的命令名称
• description：一段简短描述，会出现在 /superpowers 命令列表里
• 正文：具体说明这个 Skill 如何使用

2.3 prompt.md —— Skill 的"大脑"

这一步最为关键。prompt.md 定义了 Claude Code 执行这个 Skill 时的具体行为和输出格式。

# Code Review 提示词

你是一位资深的代码审查工程师。当用户提供代码时，请从以下维度进行审查：

## 审查维度

1. **安全性**：SQL 注入、XSS、权限验证等
2. **性能**：时间复杂度、数据库查询优化、缓存使用等
3. **可维护性**：命名规范、注释、模块化等
4. **最佳实践**：是否符合团队规范

## 输出格式

输出 Markdown 格式的报告：

```markdown
# 代码审查报告

## 概述
- 文件：xxx
- 审查时间：xxx
- 整体评分：⭐⭐⭐⭐ (4/5)

## 问题列表

###