Skill 与 Agent 进阶 · 第 2 章

动手搭建你的 AI 工作台

从零把常用 AI 工具、目录结构与调用方式搭成一套顺手的个人工作台,含目录规划与最小可用配置。

  • 学什么动手搭建你的 AI 工作台
  • 难度L0
  • 预计时间15 分钟
  • 涉及工具Skill / 工作台

动手搭建你的 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 CodeAnthropic 生态用户/plugin install~/.claude/skills/
OpenClaw开源 AI Agent 用户clawhub install~/.claw/skills/
CodexOpenAI 生态用户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 软件著作权申请工具,材料备齐再提交;登记结果以中国版权保护中心审核为准。

软著通下载入口