技能與 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"
宣告相依性可讓模型使用所需的工具,但仍須提供清楚的工作流程指示。請告訴模型應使用哪些工具、使用順序,以及結果缺漏或不明確時應如何處理。
測試技能
從使用案例清單中選取具代表性的請求來測試技能:
- 應啟用技能的直接請求。
- 以間接方式表達相同目標的請求。
- 資訊不完整、應讓模型進一步提問的輸入。
- 不應啟用技能的請求。
- 模型必須避免捏造資訊或執行不受支援操作的邊界情況。
檢查技能是否在適當時機啟用,以及輸出品質是否符合要求。如果技能在錯誤的時機啟用,請調整技能說明。如果模型選對了工作流程,產生的結果卻不一致,請調整技能指示。
打包技能
在外掛程式資訊清單中指定技能目錄:
{
"name": "dice-roller",
"version": "1.0.0",
"description": "Roll dice for tabletop games",
"skills": "./skills/",
"apps": "./.app.json"
}
如需查看完整的資訊清單、瞭解 MCP 伺服器的對應設定,以及本機測試和發布流程,請參閱打包外掛程式。