Skip to content

potato-skill：使用程式設計智慧體快速入門

向 Claude Code 描述需要人工標註的資料，potato-skill 會設計標註研究，並把它構建成帶有獨立介面的 Potato 標註任務並執行起來。

開始一個 Potato 項目有兩種方式。您可以按照快速入門自己編寫任務，也可以把研究描述給程式設計智慧體，讓 potato-skill 來設計和構建。 本頁介紹第二種方式。兩種方式的結果相同：一個可以執行、修改和分享的 Potato 標註任務。

技能負責的設計決策

potato-skill 是一個智慧體技能（agent skill），即一組說明文件和輔助指令碼，程式設計智慧體在請求需要時載入。它既負責研究的設計，也負責構建，從標籤集一直到匯出的資料：

  • 向標註員提什麼問題，使用什麼量表
  • 每個條目需要幾名標註員
  • 如何培訓標註員並檢查他們的工作
  • 標註員看到的介面
  • 啟動任務，並像標註員一樣把任務走一遍
  • 以下一步所需的格式匯出結果

它也能處理已經在執行的研究。它會報告進度和一致性，並說明標註員開始工作後哪些修改可以安全進行。

它構建的任務執行在 Potato 上，因此自帶 Potato 已有的功能：每位標註員單獨登入、每個條目由多名標註員標註、一致性統計、Prolific 和 MTurk 整合，以及匯出為下游工具可讀的格式。

前提條件

Potato 必須安裝在智慧體執行命令的環境中，因為技能的輔助指令碼會匯入 Potato 並呼叫 potato 命令：

bash
pip install potato-annotation

您還需要一個程式設計智慧體。該技能是為 Claude Code 編寫的，下一節介紹其他智慧體。

安裝技能

在 Claude Code 中：

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

對於 Codex、Cursor 和其他智慧體，可以用 skills CLI 把它安裝到您的項目中：

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

使用 --agent codex cursor 時，它會把技能複製到 .agents/skills/potato-skill/。Codex 和 Cursor 也可以讀取 potato-skill 倉庫根目錄下的 AGENTS.md 檔案。

描述研究

說明需要標註什麼、由誰來標註，以及標註結果用於何處。您不需要了解 Potato 的標註類型或配置格式。請求可以短到這樣：

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

技能會確定問題措辭、量表、條目分配方式以及對標註員的檢查方式。隨後智慧體構建任務、啟動任務，並像標註員一樣把任務走一遍，再交給您。請在瀏覽器中開啟它，先自己標註幾條，再邀請其他人。

生成的任務

一個 Potato 任務：一個項目資料夾，包含任務的配置、資料和說明。快速入門中的所有內容都適用於它。用 potato start config.yaml 啟動，可以手動編輯、新增標註員並匯出標註結果。

因為結果是一個 Potato 任務資料夾，其他人也可以使用。同事可以在新資料上運行同一個研究，您可以明年再執行一次，也可以隨論文一起釋出。展示區收錄的就是以這種方式分享、取自已發表論文的任務。

已有的設計和標註

  • 已發表的設計。 技能可以從 440 個取自已發表論文的標註設計之一開始，沿用其標籤集、問題措辭和說明。您可以在展示區瀏覽它們。
  • 其他工具的標註。 它可以匯入 Label Studio、CVAT 或 COCO 中已有的標註，讓做到一半的項目在 Potato 中繼續。
  • 正在執行的研究。 它會報告每位標註員的進度和每個問題的一致性，並說明哪些修復在研究進行中可以安全進行，哪些會破壞已收集的資料。

基於 Potato 登錄檔的測試

技能的 CI 會檢查其說明中提到的每個標註類型、配置鍵和示例配置都確實存在於 Potato 中。示例 YAML 會通過 Potato 的驗證器，完整示例會啟動一個真實的 Potato 伺服器。它有三份參考資料由 Potato 自身的登錄檔生成，因此智慧體讀到的類型和鍵，就是伺服器實際執行的那些。

它的參考資料釋出在 davidjurgens.github.io/potato-skill，無需安裝即可閱讀。Anthropic 建議在安裝任何技能之前先審閱它。

兩種方式對比

自己編寫任務描述給程式設計智慧體
起點YAML 配置一段自然語言描述
適合學習 Potato、小型任務新研究、帶培訓和檢查的眾包研究、您沒用過的標註類型
結果一個 Potato 任務一個 Potato 任務

您可以隨時切換方式。智慧體可以修改您編寫的任務，您也可以編輯智慧體構建的任務。

後續步驟