跳转到内容

在 Codex 中设置 potato-skill

用一条 npx 命令把 potato-skill 添加到 Codex 项目，用 $potato-skill 启动这个技能，并批准默认沙箱拦下的命令。

Codex 从仓库中的 .agents/skills/ 读取技能，npx skills add davidjurgens/potato-skill --agent codex 会把 potato-skill 复制到那里。Codex 无需重启就能发现这个技能，在 CLI 和 IDE 扩展中，$potato-skill 会启动这个技能。用编程智能体快速入门讲解了这个技能如何处理一项研究，在编程智能体中安装 potato-skill介绍其他智能体。

安装之前

Potato 要装在 Codex 的 shell 所用的 Python 环境中。技能的辅助脚本会导入 Potato 的注册表并调用 potato 命令，技能的第一步也会检查 Potato 能否导入。浏览器扩展和 Chromium 让 potato preview --screenshot 和技能的走查脚本能在无头浏览器中打开任务：

bash
pip install 'potato-annotation[preview]'
playwright install chromium

Codex 的默认沙箱没有网络访问。开始之前先装好这两样，可以省去一轮批准。skills CLI 通过 npx 运行，需要 Node.js 22.20 或更高版本。

安装技能

在仓库中运行安装命令：

bash
npx skills add davidjurgens/potato-skill --agent codex

这条命令会把 SKILL.md、30 个参考文件和 9 个辅助脚本复制到 .agents/skills/potato-skill/，并在仓库根目录的 skills-lock.json 中记录来源。Codex 会扫描从当前文件夹向上直到仓库根目录的每一级 .agents/skills/，所以在仓库子文件夹中启动的会话也能找到这个技能。提交 .agents/skills/ 后，协作者无需安装步骤就能得到这个技能。

加上 -g 则改为为这台机器上的每个仓库安装技能：

bash
npx skills add davidjurgens/potato-skill --agent codex -g

全局安装会放到 ~/.agents/skills/potato-skill/，这是 Codex 读取的用户级技能文件夹。Codex 无需重启就能发现新技能。如果技能没有出现，请重启 Codex。

确认安装

在 Codex CLI 或 IDE 扩展中，/skills 会列出 Codex 找到的技能，potato-skill 就在其中。在 ChatGPT 桌面应用中，侧边栏的 Skills 显示你各个项目中的技能。

开始一项研究

用 $potato-skill 提及这个技能，并描述研究：

text
$potato-skill I want 200 tweets labeled for sentiment on a 5-point scale by three annotators each, with a consent page and two attention checks. Build it and start it.

当请求符合技能的描述时，Codex 也会不经提及就加载这个技能，例如请求构建标注任务、编辑 Potato 的 config.yaml，或查看正在运行的研究。

沙箱与批准

Codex 在沙箱中运行命令。默认模式 workspace-write 允许命令在工作区内写入，并关闭网络访问。控制网络的设置是 sandbox_workspace_write.network_access，默认值为 false。在 on-request 批准策略下，Codex 在沙箱内工作，并在命令超出沙箱之前询问。

构建期间，技能会让 Codex 验证配置、在你的机器上启动 Potato 服务器、在无头浏览器中打开任务，并运行技能的辅助脚本。pip install 需要网络，而默认沙箱没有网络。Codex 询问时，请在读过命令之后批准在沙箱之外运行。在 CLI 中，/permissions 会打开权限选择器。在 IDE 扩展和应用中，同样的选项位于输入框下方，名为 Ask for approval、Approve for me 和 Full access。各个模式见 Codex 的沙箱文档。

AGENTS.md

Codex 按文件名读取 AGENTS.md。potato-skill 仓库的根目录有一个 AGENTS.md，是对技能规则的简短摘要。把这个文件复制到你的仓库根目录，Codex 无需安装步骤就能得到这些规则。这个文件指向的参考文件和脚本只有完整安装才会放到磁盘上。构建研究请使用 skills CLI 安装。如果你的仓库已经有 AGENTS.md，请把摘要加到该文件中，而不要替换这个文件。

更新和移除技能

skills CLI 按名称更新和移除技能。全局安装时，给任一命令加上 -g：

bash
npx skills update potato-skill
npx skills remove potato-skill

update 会把已安装的副本与 GitHub 仓库对照，仓库有变化时替换这份副本。remove 会删除 .agents/skills/potato-skill/ 以及 skills-lock.json 中该技能的条目。

如果只想关闭技能而不删除，可以在 ~/.codex/config.toml 中添加一个条目，写上技能的 SKILL.md 的绝对路径，然后重启 Codex。条目可用的其他设置见 Codex 的技能文档：

toml
[[skills.config]]
path = "/path/to/your/repo/.agents/skills/potato-skill/SKILL.md"
enabled = false

延伸阅读