小白也能用 Claude Code Skill：从安装到创建自己的工作流 - 博客

这篇文章写给没用过 Claude Code Skill 的人。如果你已经用过，这篇对你太基础了，去看这篇评测。

如果你是第一次听说这些概念——别急，我们慢慢来。

先搞清楚几个概念

Claude Code 是什么？

Claude Code 是 Anthropic 公司出的一个 AI 编程助手。你可以把它理解为"一个住在终端里的 AI 程序员"——你在命令行里跟它说话，它帮你写代码、改 bug、管理项目。

它不是聊天机器人。它能直接读写你电脑上的文件、运行命令、提交代码。你可以把它想象成一个坐在你旁边、能直接操作你电脑的程序员搭档。

Skill 是什么？

Skill（技能）是一组给 AI 的使用说明书。你可以把它理解为：

你雇了一个很聪明的助手。他什么都会一点，但不知道你公司的事情该怎么做。Skill 就是你的"公司手册"——告诉他遇到什么情况、按什么步骤、遵守什么规则来做事情。

比如你安装了一个"部署 Skill"，以后你跟 AI 说"帮我上线"，它就不会瞎搞，而是按照 Skill 里写的步骤：先跑测试 → 测试通过才提交代码 → 推送到服务器。

Skill 不需要你会编程。大部分 Skill 是别人写好的，你只需要"安装"它，然后像平时一样跟 AI 说话就行。

Agent 是什么？

你会在这篇文章和网上经常看到"Agent"这个词。在这个语境下，Agent 就是 AI 助手本身。有时候一个 Skill 会派出多个 Agent——相当于让好几个助手同时干活，各负责一块。

第一步：装你的第一个 Skill

别贪多。先装一个，跑通再说。

先选一个适合你的

如果你是工程师、程序员，装 Superpowers——它让 AI 按严格的流程写代码，不再乱来。

如果你是做产品的（比如独立开发者、创业者），装 GStack——它给 AI 分配不同角色，相当于帮你组建一支虚拟团队。

如果你都不确定，先装 Superpowers。它最通用。

怎么装

以下操作需要在"终端"（也叫"命令行"）里进行。如果你不知道怎么打开终端：

Mac：按Cmd + 空格，搜索"终端"

Windows：按Win + R，输入cmd，回车

装 Superpowers

把下面这行复制到终端里，按回车：

/plugin install superpowers@claude-plugins-official

等几秒钟，看到安装成功的提示就行。

装 GStack

把下面三行逐行复制到终端里，每行按回车：

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

这些命令在干什么？

第一行：从 GitHub（一个代码托管网站）把 Skill 的文件下载到你电脑上。~/.claude/skills/是 Skill 的存放目录

第二行：进入下载好的文件夹

第三行：运行安装脚本

安装后必须做的事

重启 Claude Code。不是关掉终端窗口——是在 Claude Code 里输入/exit，然后重新启动 Claude Code。Skill 只有重启后才会被识别。

第二步：跑一遍完整流程

装好之后我们来实际用一下，看看 Skill 到底做了什么。

如果你装的是 Superpowers

在 Claude Code 里跟它说：

我想给这个项目加一个用户登录功能。

你注意观察——AI 的行为变了。以前它会直接开始写代码，现在它会先问你问题：

用什么方式登录？邮箱？手机号？还是微信/Google 登录？
需要记住登录状态吗？
和现有的用户体系怎么对接？

这是 Skill 的功劳。它在强制 AI先想清楚再动手，而不是上来就写代码。

耐心回答这些问题。AI 会把你的回答整理成一份设计文档，一段一段展示给你确认。你觉得没问题就说"继续"。

然后它会把工作拆成小任务，每个任务有具体的文件路径和代码。你看一眼计划，说"go"。

最后它进入执行阶段——每个任务单独执行，做完自动检查。

可能遇到的坑：

如果你的项目没有测试框架（单元测试之类的东西），Superpowers 会先帮你建一个。这个过程可能要 5-10 分钟。别急，这是一次性的工作，以后就不用了。
第一个小任务可能会失败——因为 AI 还不够了解你的项目结构。没关系，告诉它具体的文件路径（比如"用户相关的代码在 src/users/ 文件夹里"），它会重新执行。

如果你装的是 GStack

输入/office-hours（在 Claude Code 里直接打这个就行）。然后跟它聊你要做什么。

GStack 不会让你马上写代码。它会逼你想清楚：

你要解决的具体痛点是什么？不是"我想做一个 App"，而是"我每天花两小时做 X，我想把这个降到 10 分钟"
你以为你要的功能，是不是你真正需要的？
有没有更简单的方案？

聊完之后你会得到一份设计文档。然后用/plan-ceo-review让 AI 扮演 CEO 角色审视这份设计，用/plan-eng-review让它扮演架构师检查技术方案。

这些/xxx是什么？这是 GStack 提供的"快捷命令"。你在 Claude Code 里输入斜杠开头的命令，AI 就知道要用对应的流程。就像在微信里输入@某人一样——一个特殊的指令格式。

最后说"开始实现"。AI 就按照刚才讨论好的计划写代码。

可能遇到的坑：

设计审查会打分。如果你的项目比较简单，分数可能很低。别焦虑，这是正常的——审查标准是按大项目来的。
QA 测试需要你的项目在本地能访问。如果你的项目还没跑起来，QA 没东西可测。先确保项目能正常运行再说。

第三步：让 Skill 适配你的项目

Skill 是通用的"说明书"。但你的项目有自己的规矩——比如用什么语言、文件怎么组织、代码风格是什么。

怎么让 AI 在遵守 Skill 的同时，也遵守你的项目规矩？在项目根目录创建一个CLAUDE.md文件，写上你的规则：

## 项目规范

- 使用 TypeScript strict mode（一种严格的代码检查模式）
- API 路由放在 src/app/api/ 下
- 数据库操作用 Prisma（一种数据库工具）
- 测试用 Vitest，测试文件和源文件放在同一个目录
- 提交信息用中文，格式：[类型] 描述，例如：[修复] 修复登录按钮不响应的问题

AI 在执行 Skill 指令的同时会遵守你的项目规范。如果两者冲突，CLAUDE.md里的规则优先。

如果你有多个项目：每个项目的CLAUDE.md不一样。AI 只看当前项目目录下的那个。

第四步：创建你自己的 Skill

用了一圈别人的 Skill 之后，你可能会发现"我有个流程没有现成的 Skill 可以用"。

创建一个最简 Skill 只需要两步：

1. 创建文件夹

mkdir -p ~/.claude/skills/my-deploy

mkdir是"创建文件夹"的命令。-p表示如果父文件夹不存在就一起创建。~/.claude/skills/是 Skill 的默认存放位置。my-deploy是你给这个 Skill 起的名字。

2. 写 Skill 文件

在刚创建的文件夹里新建一个SKILL.md文件，写入以下内容：

---
name: my-deploy
description: 当用户说"部署"、"上线"、"deploy"时使用这个 Skill
---

# 我的部署流程

## 触发条件
- 用户说"部署"或"deploy"
- 用户说"上线"

## 执行步骤
1. 运行 `npm run build` 确保构建成功
2. 运行 `npm run test` 确保测试通过
3. 如果构建或测试失败，停止并报告错误
4. 运行 `git add . && git commit` 提交变更
5. 运行 `git push origin main` 推送
6. 等待 CI 通过
7. 确认部署成功

## 规则
- 永远不要跳过测试
- 测试失败时不允许继续部署
- 推送前确认用户同意提交信息

重启 Claude Code，然后跟 AI 说"帮我部署"，它就会按你写的流程走。

写好 Skill 的四个诀窍

description要写清楚什么时候触发。不要写"这是一个部署工具"——AI 是根据 description 判断该不该加载这个 Skill 的。写"当用户说'部署'时使用"比写"部署工具"效果好得多。
步骤要具体到命令级别。"运行测试"不如"运行npm run test"。越具体，AI 执行得越准确。
写清楚什么情况下必须停止。护栏比流程更重要。告诉 AI "测试失败时不允许继续"，它就不会在测试挂了的情况下强行部署。
包含一个真实的例子。让 AI 知道正确的输出长什么样，它就能判断自己做得对不对。

常见问题

我装了两个 Skill 但 AI 只用一个

有些 Skill 的触发条件重叠。比如 Superpowers 和 GStack 都在"讨论需求"时触发。解决办法：在CLAUDE.md里写上"遇到需求讨论时优先使用 GStack"。

Skill 的步骤不符合我的习惯

不要直接改别人的 Skill 文件（因为他更新后你的改动会被覆盖）。在你的CLAUDE.md里写覆盖规则，或者复制一份到自己的 Skill 里再改。

AI 忽略了 Skill 的指令

Skill 是指令，不是锁。AI 有时候会因为对话太长"忘记"加载了 Skill。遇到这种情况直接提醒它："按照 my-deploy Skill 的流程来部署"。

我完全不会编程，能用 Skill 吗？

能。大部分 Skill 是别人写好的，你只需要安装。跟 AI 说话也不需要任何编程知识——用中文正常描述你想做什么就行。不过如果你要创建自己的 Skill，需要了解一些基本的终端操作（这篇已经讲了）。

在HaluTool浏览所有可用的 Skill，找到适合你的。