📊 页面导航

适用角色与上手难度

角色	推荐度	上手难度
🛠️ 开发	★★★★★	★★★★☆
🧪 测试	★★★☆☆	★★★★★
📦 产品	★★☆☆☆	★★★★★

🎯 学习产出： 掌握自定义技能开发，能独立创建、编写和部署团队专属的 Skills

🚀 AI 能力提升： 技能扩展

自定义技能

预计阅读时间: 7 分钟

Skills 是 Claude Code 的扩展机制，让你可以封装常用的工作流程。

什么是 Skill

Skill 是一个 Markdown 文件，定义了 Claude Code 在特定场景下应该遵循的指令。它可以：

封装复杂的工作流程
提供领域特定的知识
标准化团队的最佳实践

使用内置 Skills

Claude Code 有一些内置的 Skills，通过斜杠命令调用：

> /superpowers:brainstorming
> /superpowers:writing-plans
> /superpowers:test-driven-development

创建自定义 Skill

文件结构

在 .agents/skills/ 目录下创建 Skill 文件：

.agents/
└── skills/
    └── my-skill/
        └── SKILL.md

Skill 文件格式

---
name: my-skill
description: 一行描述这个 Skill 的用途
---

# Skill 标题

详细的指令内容...

## 步骤

1. 第一步做什么
2. 第二步做什么
3. ...

示例：代码审查 Skill

---
name: code-review
description: 按照团队规范审查代码改动
---

# 代码审查

按照以下维度审查代码改动：

## 审查清单

### 1. 代码质量

- [ ] 命名是否清晰
- [ ] 是否有重复代码
- [ ] 函数是否过长（超过 50 行考虑拆分）

### 2. 安全性

- [ ] 是否有硬编码的密钥或密码
- [ ] SQL 查询是否使用参数化
- [ ] 用户输入是否做了验证

### 3. 性能

- [ ] 是否有不必要的循环
- [ ] 数据库查询是否合理（避免 N+1）
- [ ] 大数据量场景是否考虑分页

### 4. 测试

- [ ] 新功能是否有测试
- [ ] 边界条件是否覆盖
- [ ] 错误场景是否测试

## 输出格式

按严重程度分类列出问题：

- 🔴 严重：必须修复
- 🟡 建议：建议改进
- 🟢 优秀：值得表扬的做法

示例：规范合规校验 Skill

当 OpenSpec 和 Superpowers 协同使用时，需要一个专门的 Skill 来校验代码是否符合 OpenSpec 规范：

~/.claude/skills/spec-compliance-check/SKILL.md

---
name: spec-compliance-check
description: 校验代码实现是否符合 OpenSpec 规范文档
---

# Spec 合规校验

## 触发条件

在代码审查阶段，自动触发此 Skill 进行规范合规校验。

## 执行步骤

1. 读取 `openspec/` 目录下的主规范和本次增量 spec 文档
2. 逐条核对 spec 中的「假设-当-则」场景是否全部实现
3. 检查 design.md 中的技术架构决策是否被遵循
4. 验证 proposal.md 中的排除范围是否未被触碰
5. 输出合规报告，违规项标记为 BUG

## 输出格式

| 检查项   | 状态  | 说明                    |
| -------- | ----- | ----------------------- |
| 场景覆盖 | ✅/❌ | spec 条目 vs 实现       |
| 架构合规 | ✅/❌ | design 决策 vs 实际代码 |
| 排除范围 | ✅/❌ | 非目标是否被实现        |

示例：双框架衔接 Skill

自动将 OpenSpec 规范文档输入 Superpowers 执行流程：

~/.claude/skills/openspec-superpowers-bridge/SKILL.md

---
name: openspec-superpowers-bridge
description: 自动衔接 OpenSpec 规范与 Superpowers 执行，消除手动配置
---

# OpenSpec-Superpowers 桥接

## 触发条件

启动 Superpowers 实现任务时自动触发。

## 执行步骤

1. 自动检索 `openspec/changes` 目录中未归档的变更文档
2. 全量加载 design.md、specs/、tasks.md 作为实现约束
3. 如果已完成 Explore/Propose，自动跳过 brainstorming 环节
4. 将 spec 业务场景转换为 TDD 测试用例
5. 将 tasks.md 任务拆分至 Superpowers 标准粒度（2-5 分钟）
6. 单任务完成后自动调用 spec-compliance-check
7. 全任务完成后强制执行 Verify + 全量测试
8. 测试全通过后才允许 Archive

Tip

这两个 Skill 解决了 OpenSpec + Superpowers 协同开发中的 5 个常见踩坑。详见双框架踩坑指南。

Skill 最佳实践

单一职责：一个 Skill 做一件事
明确指令：步骤要具体，避免模糊描述
提供示例：给出输入输出的例子
保持更新：随着项目演进更新 Skill 内容

Info

想发现更多社区 Skills？CC-Switch 内置 Skills 市场，可以浏览和一键安装来自 GitHub 的社区技能。

Info

想要一套完整的结构化开发工作流？Superpowers 插件为 Claude Code 提供了从头脑风暴到代码审查的 14 个专业 Skills。

使用 Skill

在对话中通过斜杠命令调用：

> /code-review
> 帮我审查一下最近的改动

或者让 Claude Code 自动选择：

> 帮我按照团队规范审查这段代码

Claude Code 会根据描述自动匹配合适的 Skill。

Tip

本页属于技能系统的一部分。查看更多 Skills 资源：技能市场 | Superpowers | Gstack

下一步

技能市场 — 浏览和安装社区 Skills
Superpowers 插件 — 14 个结构化开发 Skills
Gstack 工具包 — 23+ 个工程团队 Skills
多智能体工作流 — 编排多个 Agent 协作完成复杂任务
自动化与 CI/CD — 在自动化流程中使用 Claude Code

#自定义技能

#什么是 Skill

#使用内置 Skills

#创建自定义 Skill

#文件结构

#Skill 文件格式

#示例：代码审查 Skill

#示例：规范合规校验 Skill

#示例：双框架衔接 Skill

#Skill 最佳实践

#使用 Skill

#下一步