一、skill概述

1.skill作用

很多人装完 Claude Code 就只会 /init 然后聊天，Claude Code 真正的威力在 Skill——你可以把它理解成给 AI 装「专业技能包」。装一个 Skill，它就从通用助手变成某个领域的专家。

2.skill工作方式

Claude Code 的 Skill 本质是一个 Markdown 文件 + 一个 SKILL.md 的前置元数据（YAML frontmatter）。文件放在 ~/.claude/skills/ 目录或者项目的 .claude/skills/ 目录下，Claude Code 启动时自动发现。调用方式就是 /skill-name。

3、skill安装方式

1)、Marketplace 安装：在 Claude Code 里直接 /install skill-name 从官方市场拉取

2）手动安装：把 skill 仓库 clone 或下载到 skills 目录

推荐第一种，省事，自动更新。

二、三大skill作用

1. OpenSpec：帮助用户编写规格文档，

2. gstack：由23个高度定制的技能组成，将Claude Code转变为虚拟工程团队，主要作用做需求方案审核

3. Superpowers：包含多个子技能，实现闭环编程，遵循测试驱动开发理念

三、三大skill使用方法

1、OpenSpec — 从「感觉可以写」到「规格已经定了」

OpenSpec 是目前 Claude Code 生态里最重要的 Skill 之一，代表了从 Vibe Coding 到 SDD（Spec-Driven Development） 的范式转移。

OpenSpec主要是写规格文档——接口定义、数据模型、异常处理策略、测试用例——全都写清楚，然后 AI 按照规格来写代码。

1）安装方式

/install openspec

装完之后有几个核心命令：

• /openspec:propose — 你描述需求，它输出完整技术规格

• /openspec:apply — 按规格生成代码

• /openspec:review — 对照规格检查代码是否一致

• /openspec:archive — 归档规格，以后可追溯

2）案例

功能：录音 mp3 文件转文字，支持最长 30 分钟录音，结果写入 MySQL

使用步骤：

第一步：/openspec:propose 录音 mp3 文件转文字，支持最长 30 分钟录音，结果写入 MySQL。Claude Code 输出了完整规格：

• API 契约（请求体、响应体、错误码）

• 数据库 schema（字段类型、索引、分表策略）

• 异常处理矩阵（网络超时、ASR 服务不可用、文件格式不支持……）

• 性能要求（30 分钟音频转文字 < 2 分钟）

• 测试用例（正常流程 3 个 + 异常流程 5 个）

第二步：review 规格，改了两处（分表策略从按月改成按天，异常重试次数从 3 次改成 5 次）。

第三步：/openspec:apply。代码生成，对照规格一行行 check。结果：一次联调通过，零 bug。

注意：以前的 Vibe Coding 方式做到一次过是不可能的。区别就在于规格先于代码。

2、gstack — YC 总裁的虚拟工程团队

gstack 是 Y Combinator CEO Garry Tan 开源的 Claude Code 配置——23 个高度定制的 Skill，把 Claude Code 变成了一个虚拟工程团队，包括CEO、设计师、工程经理、发布经理、文档工程师、QA。所有这些角色都是 slash command，都是 Markdown 写的，MIT 协议，免费。

1）安装方式

git clone --single-branch --depth 1https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup

然后让 Claude Code 在 CLAUDE.md 里加上 gstack 配置段：

告诉 Claude Code：将 gstack section 添加到 CLAUDE.md，
列出所有可用 skill：/office-hours, /plan-ceo-review, /plan-eng-review, 
/plan-design-review, /review, /ship, /qa, /cso, /autoplan, /retro, 
/investigate, /browse 等，并要求所有网页浏览使用 /browse skill

如果想让整个团队都用，加上 --team 参数：

(cd ~/.claude/skills/gstack && ./setup --team) && ~/.claude/skills/gstack/bin/gstack-team-init required && git add .claude/ CLAUDE.md && git commit -m "require gstack for AI-assisted work"

核心 Skill 包括：

    /office-hours — 产品思路不清？6 个追问式问题帮你理清楚你到底要做什么

    /plan-ceo-review — CEO 视角的战略评审，把你从技术细节里拽出来看全局

    /plan-eng-review — 工程经理视角，锁定架构方案

    /plan-design-review — 设计师视角，AI 生成的 UI 通常很丑，这个帮你纠偏

    /review — 代码审查，找生产环境 bug

    /qa — 在你 staging 环境上开真实浏览器测试

    /cso — 安全审计，跑 OWASP + STRIDE

    /ship — 打包发布 PR

    /autoplan — 自动规划 + 执行 + 发布一条龙

    /retro — 每周工程回顾

    /investigate — 根因排查方法论

2）案例

这个工具的厉害之处不在于某个单独的功能，而在于角色切换，做方案设计

gstack 的价值：让 CEO 审你的方案、让设计师看你的 UI、让安全工程师跑你的代码——现在全部自动化了。

3、Superpowers — 把 Claude Code 变成超级战士

Superpowers 是一套「元 Skill」，包含了十几个子 skill，每个解决一类特定问题。它不是让你做某一件事，而是教你如何更好地使用 Claude Code 本身。

1）安装

/install superpowers

装完之后你的 skills 列表里会多出十几个 /superpowers:xxx 命令。

核心子 skill 包括：

    superpowers:brainstorming — 需求还没想清楚？它会用结构化方式带你头脑风暴

    superpowers:executing-plans — 有方案了不知道怎么落地？它帮你拆成可执行步骤

    superpowers:writing-skills — 教你写你自己的 Skill（这个我团队人手一个）

    superpowers:subagent-driven-development — 自动拆任务、派发给子 agent 并行执行

    superpowers:systematic-debugging — bug 修了又出来？它有一套系统化排查流程

四、三件套组合使用方法

工具单用都有局限，组合起来才是生产力，实际在用的流程：

1.接到模糊需求→/office-hours（gstack）
—6个追问把需求榨干，搞清楚你到底要解决什么问题

2.思路成型了→/plan-ceo-review（gstack）
—CEO视角：这个功能的核心指标是什么？不做会死吗？第一版能不能砍掉50%？

3.战略通了→/plan-eng-review（gstack）
—工程经理视角：架构怎么设计？和现有系统怎么对接？技术风险在哪里？

4.方案需要头脑风暴→/superpowers:brainstorming
—多方案对比、边界条件梳理、别急着动手

5.方案定了→/openspec:propose
—输出完整技术规格：API契约、数据模型、异常矩阵、测试用例

6.UI相关的→/plan-design-review（gstack）
—AI生成的UI通常很丑，让设计视角纠正一下

7.生成代码→/openspec:apply
—按规格生成，偏没偏一眼看出来

8.代码审查→/review（gstack）
—逻辑正确性、命名规范、测试覆盖、安全问题，逐项过

9.安全检查→/cso（gstack）
—OWASP+STRIDE，别等到线上出事了再补

10.QA测试→/qa（gstack）
—在staging环境开真实浏览器跑一遍

11.发布→/ship（gstack）
—打包、打tag、推PR，一条命令

12.迭代复盘→/retro（gstack）
—每周回顾：什么做对了，什么做慢了，流程哪里可以改进