跳轉到內容

在 Claude Code 中設定 potato-skill

把 potato-skill 作為 Claude Code 外掛安裝，選擇決定誰能用到外掛的作用域，並批准技能執行的命令。

Claude Code 把 potato-skill 作為外掛安裝，先執行 /plugin marketplace add davidjurgens/potato-skill，再執行 /plugin install potato-skill@potato。這個外掛只帶一個技能，沒有智慧體、鉤子或 MCP 伺服器，只要請求與構建或執行標註研究有關，Claude 就會載入這個技能。 potato-skill 最初就是為 Claude Code 編寫的，這條路線能得到技能設計中的每個部分。用程式設計智慧體快速入門講解了這個技能如何處理一項研究，在程式設計智慧體中安裝 potato-skill介紹其他智慧體。

安裝之前

Potato 要裝在 Claude Code 的 shell 所用的 Python 環境中。技能的輔助指令碼會匯入 Potato 的登錄檔並呼叫 potato 命令，技能的第一步也會檢查 Potato 能否匯入。瀏覽器擴充套件和 Chromium 讓 potato preview --screenshot 和技能的走查指令碼能在無頭瀏覽器中開啟任務：

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

安裝外掛

在 Claude Code 會話中，先新增外掛市場，再安裝外掛：

text
/plugin marketplace add davidjurgens/potato-skill
/plugin install potato-skill@potato

安裝命令會在 /plugin 面板中開啟外掛的詳情，並詢問作用域：

作用域誰能用到這個技能Claude Code 記錄外掛的位置
User（使用者）你自己，在這臺機器上的每個項目中~/.claude/settings.json
Project（項目）在這個倉庫中工作的所有人.claude/settings.json，需要你提交
Local（本地）你自己，僅限這個倉庫.claude/settings.local.json

User 作用域適合在多個項目資料夾中構建研究的研究者。Project 作用域適合多項研究共用一個倉庫的實驗室。提交 .claude/settings.json 會為協作者啟用這個外掛，但不會把外掛下載到他們的機器上。每位協作者需要執行一次安裝：

bash
claude plugin install potato-skill@potato --scope project

安裝指令碼可以在你的 shell 中運行同樣的兩個步驟，無需開啟會話：

bash
claude plugin marketplace add davidjurgens/potato-skill
claude plugin install potato-skill@potato

從 shell 安裝的外掛會在 Claude Code 下次啟動時載入，已經開啟的會話則在執行 /reload-plugins 之後載入。同一臺電腦上的終端、桌面應用的本地會話和 VS Code 擴充套件讀取同樣的設定檔案。在這三者中任意一個裡做的 User 作用域安裝，另外兩個也能用到。

確認安裝

在 shell 中執行 claude plugin list，會列印外掛及其版本、作用域和狀態：

text
  ❯ potato-skill@potato
    Version: 1.2.0
    Scope: user
    Status: ✔ enabled

claude plugin details potato-skill 列出一個技能，沒有智慧體、鉤子或 MCP 伺服器。同一條命令還會估算技能佔用的上下文：技能的名稱和描述在每個會話中約佔 220 個 token，每次載入技能時約佔 10,900 個 token。

開始一項研究

用日常語言描述研究。當請求符合技能的描述時，Claude 會不借助命令載入這個技能，例如請求構建標註任務、編輯 Potato 的 config.yaml，或檢視正在執行的研究：

我想讓三名標註者分別對 200 條推文按 5 點量表標註情感傾向，並加上一個知情同意頁面和兩道注意力檢查題。構建好並啟動它。

外掛技能以外掛名命名。在請求前輸入 /potato-skill:potato-skill 會直接載入這個技能。輸入 / 會在命令選單中顯示這個名稱，/skills 則列出 Claude Code 已載入的所有技能。

批准技能執行的命令

技能會讓 Claude 驗證配置、啟動 Potato 伺服器、在無頭瀏覽器中開啟任務，並執行技能的輔助指令碼。其中每一項都是 shell 命令。在預設的 Manual 模式下，Claude Code 會在執行 shell 命令之前詢問，回答 "Yes, and don't ask again" 會在該倉庫中為這條命令儲存一條規則。

構建一項研究會多次執行 potato validate 和 potato preview。.claude/settings.json 中的允許規則會提前批准這兩條命令，其餘命令仍然會彈出詢問：

json
{
  "permissions": {
    "allow": [
      "Bash(potato validate *)",
      "Bash(potato preview *)"
    ]
  }
}

/permissions 顯示每條規則及其來自哪個設定檔案。potato-skill 沒有宣告 allowed-tools。技能請求的每條命令都要經過你的許可權設定。規則語法和其他許可權模式見 Claude Code 的許可權文件。

不使用外掛系統安裝

skills CLI 會把同樣的檔案放進項目中的 .claude/skills/potato-skill/，Claude Code 會從那裡讀取項目技能：

bash
npx skills add davidjurgens/potato-skill --agent claude-code

項目技能的名稱不帶外掛字首，因此 /potato-skill 即可載入這個技能。提交 .claude/skills/ 後，協作者無需安裝步驟就能得到這個技能。Cursor、VS Code 中的 GitHub Copilot 和 OpenCode 也讀取 .claude/skills/。該 CLI 需要 Node.js 22.20 或更高版本。Claude Code 的雲端會話不會載入安裝在你自己機器上的外掛。雲端會話執行在 claude.ai/code 的瀏覽器中。

更新和移除外掛

只有當外掛所在的市場開啟了自動更新，Claude Code 才會自動更新外掛，而手動新增的市場（例如 davidjurgens/potato-skill）預設關閉自動更新。在 shell 中更新外掛：

bash
claude plugin update potato-skill@potato

如果想自動更新，執行 /plugin，開啟 Marketplaces 標籤頁，選擇 potato，再選擇 Enable auto-update。正在執行的會話保持它載入時的版本，下一個會話才會載入新版本。

claude plugin uninstall potato-skill@potato 會移除外掛。/plugin marketplace remove potato 會移除這個市場以及從該市場安裝的所有外掛。/plugin 面板的完整說明見 Claude Code 的外掛文件。

延伸閱讀