跳转到内容

在编程智能体中安装 potato-skill

在 Claude Code、Codex、Cursor 或其他编程智能体中安装 potato-skill，并给出各智能体的安装命令和技能文件夹。

potato-skill 是一个智能体技能（Agent Skill），即一个包含说明和辅助脚本的文件夹，任何支持这一格式的编程智能体都可以加载它。Claude Code 把 potato-skill 作为插件安装，其他智能体则通过 npx skills add davidjurgens/potato-skill 得到这个文件夹，并在 --agent 之后写上智能体的名称。 Claude Code、Codex 和 Cursor 各有一个单独的设置页。用编程智能体快速入门讲解了这个技能如何处理一项研究。

各智能体的安装命令

智能体安装智能体读取的文件夹设置页
Claude Code/plugin marketplace add davidjurgens/potato-skill，然后 /plugin install potato-skill@potatoClaude Code 的插件缓存Claude Code
Codexnpx skills add davidjurgens/potato-skill --agent codex.agents/skills/Codex
Cursornpx skills add davidjurgens/potato-skill --agent cursor.agents/skills/Cursor
VS Code 中的 GitHub Copilotnpx skills add davidjurgens/potato-skill --agent github-copilot.agents/skills/见下文
Gemini CLInpx skills add davidjurgens/potato-skill --agent gemini-cli.agents/skills/见下文
OpenCodenpx skills add davidjurgens/potato-skill --agent opencode.agents/skills/见下文

potato-skill 最初是为 Claude Code 编写的，技能的 SKILL.md 也列出了 Codex 和 Cursor 的安装文件夹。GitHub Copilot、Gemini CLI 和 OpenCode 加载的是同样的文件。在邀请标注者之前，先在浏览器中打开智能体构建的第一个任务，自己标注几条。

安装之前

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

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

skills CLI 通过 npx 运行。1.7.6 版的 CLI 要求 Node.js 22.20 或更高版本。

skills CLI 会写入什么

npx skills add 会把 SKILL.md、30 个参考文件和 9 个辅助脚本复制到 .agents/skills/potato-skill/，并在项目根目录的 skills-lock.json 中记录来源。加上 -g 则安装到 ~/.agents/skills/potato-skill/，这台机器上的每个项目都可以使用。Codex、Cursor、VS Code 中的 GitHub Copilot、Gemini CLI 和 OpenCode 都读取 .agents/skills/。一条命令可以同时列出其中几个智能体，这些智能体随后共用同一份副本：

bash
npx skills add davidjurgens/potato-skill --agent codex cursor github-copilot gemini-cli opencode

CLI 支持的其他智能体的 --agent 名称和文件夹见 CLI 的智能体对照表。本页提到的每个智能体也都会在请求符合技能描述时（例如请求构建标注任务）不借助命令直接加载这个技能。

VS Code 中的 GitHub Copilot

在本地会话中，VS Code 除了 Copilot 自己的 .github/skills/，还会读取 .agents/skills/ 和 .claude/skills/。技能在聊天模式和智能体模式下都可使用。在聊天中输入 /potato-skill 即可启动这个技能。

Gemini CLI

Gemini CLI 读取工作区中的 .agents/skills/ 和用户目录下的 ~/.agents/skills/。/skills list 会显示 Gemini 找到的技能。Gemini 会在请求匹配时不借助命令启动技能，并在把技能载入对话之前请你确认。

OpenCode

OpenCode 读取从当前文件夹向上直到 git 工作树的每一级文件夹中的 .agents/skills/，全局安装则读取 ~/.agents/skills/。智能体通过 OpenCode 的 skill 工具加载匹配的技能。

不使用 skills CLI

potato-skill 仓库的根目录有一个 AGENTS.md，是对技能规则的简短摘要，Codex 和 Cursor 按文件名读取。把这个文件复制到项目根目录，智能体无需安装步骤就能得到这些规则。这个文件指向的参考文件和脚本只有完整安装才会放到磁盘上。用编程智能体快速入门比较了完整安装与复制 AGENTS.md 这两种做法。参考文件也发布在 davidjurgens.github.io/potato-skill。能读取网页的智能体可以使用发布的副本，你也可以在安装之前在那里阅读这些文件。

更新和移除技能

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

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

update 会把已安装的副本与 GitHub 仓库对照，仓库有变化时替换这份副本。remove 会删除 .agents/skills/potato-skill/ 以及 skills-lock.json 中该技能的条目。更新和移除插件的命令见 Claude Code 页面。

延伸阅读