跳轉到內容

在 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

延伸閱讀