Skill 与 Agent 进阶 · 第 2 章
动手搭建你的 AI 工作台
从零把常用 AI 工具、目录结构与调用方式搭成一套顺手的个人工作台,含目录规划与最小可用配置。
动手搭建你的 AI 工作台
🎯 学什么:搭好 Skill 开发环境,能安装/创建/测试任何 Skill。 💡 难易度:⭐ | ⏱️ 预计时间:45 分钟
1. 课程概览
💡 白话小课堂: 上一课讲了"Skill是什么",这一课咱们真正动手。就像学游泳不能光看书,你得先换上泳衣、走到池边——这节课就是帮你"换上泳衣"。
上节课我们理解了 Skill 的本质。这节课我们把它跑起来。
学完这节课你将能:
- 安装 Claude Code 或 OpenClaw 的 Skill
- 创建一个最简 Skill 并让 AI 调用它
- 理解不同平台(Claude Code、OpenClaw、Codex)的安装差异
- 掌握 npx skills 和 /plugin 两条安装路径
2. 平台选择
💡 白话小课堂:Skill 就像音乐CD——不管你在索尼播放器还是飞利浦播放器上放,内容都一样。Claude Code、OpenClaw、Codex 就是不同品牌的"播放器",安装方式不同,但 Skill 本身是通用的。
Skill 基于开放的 Agent Skills 协议,兼容多个平台。选择你的平台:
| 平台 | 适合人群 | Skill 安装方式 | Skill 存放位置 |
|---|---|---|---|
| Claude Code | Anthropic 生态用户 | /plugin install | ~/.claude/skills/ |
| OpenClaw | 开源 AI Agent 用户 | clawhub install | ~/.claw/skills/ |
| Codex | OpenAI 生态用户 | Codex 市场 | ~/.codex/skills/ |
| 通用工具 | 跨平台用户 | npx skills add | .agents/skills/ |
💡 本教程默认使用 Claude Code,但所有 Skill 内容跨平台通用。
3. Claude Code 环境搭建(Windows)
3.1 安装 Claude Code
⚠️ 避坑指南: 安装前确保 Node.js(Node.js:让 JavaScript 脱离浏览器在服务器/电脑上运行的执行环境,npm 是其自带的包管理器)版本是 18 以上。你可以在命令行输入
node -v查看版本。
# 1. 安装 Node.js 18+(如果还没装)
# 下载:https://nodejs.org/
# 2. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
# npm(Node 包管理器:JavaScript 世界最大的"应用商店",-g 参数表示全局安装,装完可在任何目录使用该命令)
# 3. 验证安装
claude --version
3.2 Skill 插件市场
# 添加 Anthropic 官方市场
/plugin marketplace add anthropics/skills
# 添加 Corey Haines 营销 Skill 市场
/plugin marketplace add coreyhaines31/marketingskills
# 查看已安装的市场
/plugin marketplace list
3.3 安装你的第一个 Skill
💡 白话小课堂:安装 Skill 就像在手机上装App。先打开"应用商店"(添加 marketplace),然后搜App名字点安装(
/plugin install),装完就能用了。
# 安装一个 Skill
/plugin install webapp-testing@anthropic-agent-skills
# 安装多个 Skill(营销工具集)
/plugin install marketing-skills
# 查看已安装的 Skill
/plugin list
3.4 测试:AI 是否调用了 Skill?
安装 copywriting Skill 后,试试这个对话:
🔑 核心秘诀: 怎么验证Skill装成功了?很简单——看输出格式。
你:帮我写个 landing page 的标题,我的产品是 AI 日程助手
观察 AI 的回复中是否出现了:
✓ 结构化输出(标题、副标题、CTA)
✓ 注解(解释为什么这样写)
✓ 备选方案(2-3 个标题选项)
如果 AI 自动按专业文案格式输出了 → Skill 生效了!✅
4. 通用安装方式:npx skills
💡 白话小课堂:
npx skills(npx:Node.js 生态中的"即用即走"命令执行器,不需要全局安装就能运行 npm 包,用完即释放空间)是"万能安装器"——不管你用哪个AI平台,它都能装。就像USB-C转接头,插什么设备都能用。
npx skills 是跨平台标准工具,不绑定任何 AI 平台。
# 安装 npx skills 工具
npm install -g @anthropic-ai/skills
# 安装任意 Skill
npx skills add coreyhaines31/marketingskills --skill copywriting
npx skills add jimliu/baoyu-skills --skill baoyu-comic
npx skills add alchaincyf/darwin-skill
# 查看已安装的 Skill
npx skills list
# 移除 Skill
npx skills remove copywriting
npx skills 安装路径
flowchart TD
root["项目根目录/"] --> agents[".agents/"]
agents --> skills["skills/"]
skills --> cw["copywriting/"]
cw --> skmd["SKILL.md"]
cw --> refs["references/"]
cw --> more["..."]
5. 手动安装(理解底层)
💡 白话小课堂:自动安装不行的时候,你得会手动操作——就像自动挡车坏了,你要会开手动挡。手动安装就是"下载文件→放到指定文件夹",很直接。
有时候你需要手动安装(比如安装 gstack 这样的复杂 Skill):
# 1. 克隆仓库(git clone:从 GitHub 等远程仓库下载完整项目代码到本地)
git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack
# 2. 运行项目自带的安装脚本
cd ~/.claude/skills/gstack
./setup
# 3. 如果是单个 Skill(不需要安装脚本):
mkdir -p ~/.claude/skills/my-skill
cp my-skill/SKILL.md ~/.claude/skills/my-skill/
6. 创建你的第一个 Skill
让我们动手做一个。以下操作不需要任何工具,只需要一个文本编辑器和终端。
🔑 核心秘诀:制作Skill最简公式
做出来了,下一步:登记
项目能跑只是前半程。源码文档整理、申报材料生成这类重复劳动,可以交给软著通——AI 软件著作权申请工具,材料备齐再提交;登记结果以中国版权保护中心审核为准。