技能教程 · 代理
工作坊技能进 OpenAI Codex
Codex 读技能的姿势和 Claude Code 一致:~/.codex/skills/<name>/SKILL.md。WorkshopSkill 的包就是这个形状——一条 curl 加一次解压,没有第三步。
安装
装两个技能进 Codex
mkdir -p ~/.codex/skills cd "$(mktemp -d)" curl -LO https://workshopskill.com/zh/activities/blind-portrait/files/blind-portrait.zip curl -LO https://workshopskill.com/zh/activities/paper-tower/files/paper-tower.zip unzip -o '*.zip' mv blind-portrait paper-tower ~/.codex/skills/
(可选)用 AGENTS.md 指路
如果备课固定在某个文件夹,给它的 AGENTS.md 加一段,让每个 Codex 会话都知道抽屉在哪——技能本就自动加载,这段只是把话说明白:
AGENTS.md
# 工作坊备课 技能目录在 ~/.codex/skills/。收到备课需求时, 先按 description 匹配技能,再照 SKILL.md 的命令执行。 索引:https://workshopskill.com/zh/skills.json
首跑
终端里的一来一回
> 90 分钟、15 人、没投影,帮我备 Codex 拿需求过滤已装技能,给出: 开场:两真一假(15 分钟,测评型) 主活动:纸塔(30 分钟,3-5 人队) 收尾:离场小票(3 分钟,工具型,零账号) 然后逐个跑 curl 步驟,用 props 字段列采购清单
卡住了?
- 技能太多?只留你常带的类目,其余一条 curl 就在 skills.html。
- 沙箱拦网络?curl 步骤是匿名下载:放行,或自己跑完两条下载再把目录交给 Codex。
- FormLM 登录不了?每个测评型 SKILL.md 里都有无头降级说明。
接着读
常见问题
Codex 哪个版本开始支持技能?
2025 年起的 Codex CLI 支持 skills 目录;如果你的构建还没有,粘贴执行那篇对所有代理通用。
一次会话能同时用多个技能吗?
这正是设计用法:人数、时长、场地三个约束对着每个技能的 frontmatter 一起算。
安装会回传什么吗?
不会。对 workshopskill.com 的 curl 是静态文件下载,无账号、无密钥、无遥测。