如果您有可重複的工作和目標 Microsoft 體驗,請使用本文來決定是否要建立技能或調整現有的技能內容。 然後,選擇產品的製作步驟。 您正在 組建或重複使用中。 您的成果是技能實作及其相依性和測試證據,可在 封裝 & 測試之前準備好整合。
重複使用或延伸技能
對於宣告式代理程式,Agent Builder 和 Agents Toolkit 不支援跨代理程式重複使用。 遵循宣 告式代理程式技能中的支援矩陣;不要假設附加到一個客服專員的技能可以與另一個客服專員共用。
建立技能之前:
- 檢閱已執行必要工作的核准技能。
- 確認目標代理程式或 Microsoft 體驗支援技能格式和功能。
- 檢閱其指示、資源、指令碼、工具和資料存取。
- 在調整現有技能內容之前,請檢查目標體驗記錄的重複使用限制。
- 確認擁有權、版本設定、共用、支援和更新期望。
- 使用代表性輸入和預期輸出測試技能。
當沒有現有核准的技能符合需求或目標體驗不支援重複使用時,請建立新技能。
選擇實作路徑
從專業發展的 Work IQ 開發工具開始。 選擇適合您目標體驗和專案類型的路線;共用 SKILL.md 格式不會建立跨代理程式重複使用或發佈資格。
| 開發方法 | 技能成品和範圍 | 開始使用 |
|---|---|---|
| Work IQ 開發工具 | 獨立外掛程式中的頂層技能資料夾,或新增至現有宣告式代理程式專案的技能。 這些是單獨的製作路由。 | 使用 Work IQ 開發工具和以下路線詳細資訊建置外掛程式 |
| Copilot Chat 技能製作和外掛程式發佈 | 請遵循產品特定的製作和發佈指導方針。 | 建立 Copilot Chat 的技能 |
| 代理程式建立器 | 上傳至宣告式代理程式的完整技能 ZIP,或從 Agent Builder 中的描述建立的技能。 | 使用 Agent Builder 新增技能 |
| Microsoft 365 代理程式工具組 | 新增至現有宣告式代理程式專案的技能目錄,而不是獨立技能 ZIP。 | 使用 Agents Toolkit 新增技能 |
| Copilot Cowork | 在 Microsoft 365 應用程式套件中註冊的技能資料夾。 使用 Cowork 套件需求和限制。 | 為 Copilot Cowork 建置外掛程式 |
將成品與其發佈路由進行比對
請遵循成品的發佈指引:
- 獨立 WIQD 外掛程式:與選取的使用者共用或提交至貴組織的目錄。 共用不是目錄發佈。
- Copilot Cowork 套件:遵循發佈到您的租用戶。
- 具有下列技能的宣告式代理程式: 請遵循發佈您的 Microsoft 市集 代理程式 提交。
支援一個成品並不會建立每個外掛程式套件的發佈資格。 發行未完成使用者存取、同意或連線設定。
GitHub Copilot 可以協助掌握技能指示、支援指令碼、資源、測試和存放庫變更。 目標體驗和製作工具會決定支援的技能格式和執行階段。
Work IQ 開發工具
WIQD 提供兩種不同的技能撰寫途徑。
-
wiqd plugin add skill將頂層技能新增至獨立的外掛程式專案。 外掛程式可以是僅限技能的,也可以將技能與支援的代理程式或遠端 MCP 連接器結合使用。 請分別確認目標產品的支援。 -
wiqd agent add skill新增技能至現有的宣告式代理程式專案。 此路由使用agent-skills功能旗標,預設為關閉。
這兩種路由都會建立以 SKILL.md-為基礎的功能,但它們在不同的專案類型上運作。 在 WIQD 外掛程式格式中,技能名稱必須符合其資料夾名稱,而且其描述應包含啟用該技能的片語。 請參閱什麼是 外掛程式? 和 外掛程式製作參考。
WIQD 來源驗證 (wiqd plugin validate --mode source) 不會檢查技能內容。 封裝之後,使用實際的 ZIP 路徑執行 wiqd plugin validate --mode package --package-file "<path-to-existing-zip>" 。 封裝驗證會將該 ZIP 的擷取複本上傳到 Microsoft 365 驗證服務,而且可能需要驗證。 檢閱傳回的結果;傳遞不會建立執行階段行為。 請參閱 驗證和 MVL。
實作技能
完成適用的工作:
- 定義作業、輸入、預期輸出、界限和成功準則。
- 建立或匯入技能指示。
- 新增必要的支援資源和指令碼。
- 設定任何必要的工具、遠端 MCP 伺服器、API、身分識別、權限或資料相依性。
- 確認支援的檔案類型、指令碼類型、沙箱行為、儲存空間和敏感度需求。
- 測試預期、不明確、不支援和失敗案例。
- 記錄技能版本、擁有者、相依性、已知限制和支援程序。
如需直接在 Copilot Chat 中使用的技能,請參閱組建 Copilot Chat 的技能。 如需宣告式代理程式的目前支援及執行階段限制,請參閱 宣告式代理程式的技能。 若為 Copilot Cowork,請參閱隨附檔案限制。 當您將技能散發給多個體驗時,套用每個目標主機的需求。
確認該技能可正常使用
在下列情況下,技能已準備好整合:
- 目標代理程式或體驗可以載入並使用它。
- 其指令會一致地執行定義的工作。
- 必要的資源、指令碼、工具和資料可供使用。
- 權限和外部相依性適用於開發或測試環境。
- 不受支援或失敗的作業會產生可理解的行為。
- 所有權、版本設定、限制和測試證據都會被記錄下來。
繼續進行計劃中的任何其他元件。 完成後, 請整合並測試您的元件,然後移至 [套件 & 測試 ] 以 建立外掛程式套件。