如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
總覽 智慧體存取權 ChatGPT 與 Codex 使用者文件 使用案例

建立技能

運用外掛程式的 MCP 工具,建立可重複執行的工作流程。

技能與 MCP 伺服器相輔相成。技能會指引 ChatGPT 和 Codex 如何在可重複執行的工作流程中使用伺服器提供的工具。由伺服器提供即時資料、處理身分驗證與授權,並執行受控操作。在技能中說明工具的使用順序、何時需要做決定,以及輸出須符合哪些要求,並提供範例、範本和其他可重複使用的指引。

一個外掛程式可以包含一項技能或一組相關技能。每項技能都應聚焦於使用案例清單中一個明確的使用者目標。如果工作流程只需要隨技能打包的指示和資源,技能也可以在沒有 MCP 伺服器的情況下運作。

建立技能

最快的入門方式是使用內建的技能建立工具。請描述使用者的目標,以及可協助達成目標的 MCP 工具:

@skill-creator 請建立名為 tabletop-dice 的技能,讓它能解讀 3d6 這類骰子記法,針對每顆骰子各呼叫一次 roll_dice,並回報每顆骰子擲出的點數和總點數。

在 Codex 中,使用 $skill-creator 即可叫用同一個工具。

你也可以手動建立檔案。每項技能都有自己的目錄,其中必須包含 SKILL.md 檔案:

  • skills
    • tabletop-dice
      • SKILL.md 必要的指示和中繼資料
      • references 選用的說明文件
      • scripts 選用的可執行程式碼
      • assets 選用的範本和資源

撰寫 SKILL.md

先在檔案開頭填寫名稱和說明,再撰寫指示:

---
name: tabletop-dice
description: Roll one or more dice for tabletop games and report each result and the total.
---

使用者要求擲骰子時,請使用這項技能。

1. 如果請求使用 `NdS` 記法,N 表示骰子數量,S 表示每顆骰子的面數。例如,`3d6` 表示三顆六面骰。
2. 針對使用者要求擲的每顆骰子,各呼叫一次 `roll_dice`,並將 S 傳入 `sides` 參數。
3. 依序回報工具每次傳回的結果。
4. 如果使用者要求擲多顆骰子,請將各顆骰子的點數相加,並回報總點數。

除非使用者明確要求,否則不得捏造或替換任何結果,也不得重擲骰子。

模型會根據說明判斷何時應考慮使用這項技能。請在說明中寫明工作流程及其觸發條件,並在正文中詳述操作步驟、格式要求和安全指示。

界定工作流程的適用範圍

每項技能都應對應一或多個使用案例。指示應清楚說明以下事項:

  • 工作流程需要哪些輸入。
  • 模型應遵循哪些步驟。
  • 使用者應收到哪些輸出。
  • 哪些事實不得由模型自行推斷。
  • 工作流程應在何時提問、停止執行或拒絕請求。
  • 模型應查閱哪些輔助檔案。

每項技能宜聚焦於單一目標,避免把大量關聯不大的指示放在一起。如果工作流程的觸發條件、輸入或成功標準不同,請將它們拆開。

檢查模型能否遵循指示

為 GPT-6 Astra 撰寫或匯入技能時,請參閱指示遵循指南。檢查技能和輔助檔案中是否有含糊或互相衝突的指示,並清楚說明使用者的明確指示優先於技能指引。

加入輔助資源

讓 SKILL.md 保持精簡,將詳細資料放在同一目錄下:

  • 在 references/ 中存放政策、結構描述、範例和背景資料。
  • 在 assets/ 中存放工作流程需要複製或轉換的範本或檔案。
  • 如果工作流程需要執行結果可重現的運算或處理檔案,請將指令碼放在 scripts/ 中。

在 SKILL.md 中引用輔助檔案,並說明何時應載入或執行這些檔案。如果依照指示使用現有工具就能可靠地完成任務,請勿新增指令碼。

將技能連接到 MCP 工具

技能可以引導模型使用外掛程式的 MCP 伺服器提供的工具。在技能中說明工作流程,由伺服器提供即時資料、處理授權並執行受控操作。

如果技能需要 MCP 伺服器,請在 agents/openai.yaml 中宣告這項相依性:

dependencies:
  tools:
    - type: "mcp"
      value: "dice-roller"
      description: "Roll an N-sided die"
      transport: "streamable_http"
      url: "https://tinymcp.dev/api/moldy-aloof-zettabyte/mcp"

宣告相依性可讓模型使用所需的工具,但仍須提供清楚的工作流程指示。請告訴模型應使用哪些工具、使用順序,以及結果缺漏或不明確時應如何處理。

測試技能

從使用案例清單中選取具代表性的請求來測試技能:

  1. 應啟用技能的直接請求。
  2. 以間接方式表達相同目標的請求。
  3. 資訊不完整、應讓模型進一步提問的輸入。
  4. 不應啟用技能的請求。
  5. 模型必須避免捏造資訊或執行不受支援操作的邊界情況。

檢查技能是否在適當時機啟用,以及輸出品質是否符合要求。如果技能在錯誤的時機啟用,請調整技能說明。如果模型選對了工作流程,產生的結果卻不一致,請調整技能指示。

打包技能

在外掛程式資訊清單中指定技能目錄:

{
  "name": "dice-roller",
  "version": "1.0.0",
  "description": "Roll dice for tabletop games",
  "skills": "./skills/",
  "apps": "./.app.json"
}

如需查看完整的資訊清單、瞭解 MCP 伺服器的對應設定,以及本機測試和發布流程,請參閱打包外掛程式。