跳轉到內容

在程式設計智慧體中安裝 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 頁面。

延伸閱讀