組建或重複使用技能

如果您有可重複的工作和目標 Microsoft 體驗,請使用本文來決定是否要建立技能或調整現有的技能內容。 然後,選擇產品的製作步驟。 您正在 組建或重複使用中。 您的成果是技能實作及其相依性和測試證據,可在 封裝 & 測試之前準備好整合。

重複使用或延伸技能

對於宣告式代理程式,Agent Builder 和 Agents Toolkit 不支援跨代理程式重複使用。 遵循宣 告式代理程式技能中的支援矩陣;不要假設附加到一個客服專員的技能可以與另一個客服專員共用。

建立技能之前:

  1. 檢閱已執行必要工作的核准技能。
  2. 確認目標代理程式或 Microsoft 體驗支援技能格式和功能。
  3. 檢閱其指示、資源、指令碼、工具和資料存取。
  4. 在調整現有技能內容之前,請檢查目標體驗記錄的重複使用限制。
  5. 確認擁有權、版本設定、共用、支援和更新期望。
  6. 使用代表性輸入和預期輸出測試技能。

當沒有現有核准的技能符合需求或目標體驗不支援重複使用時,請建立新技能。

選擇實作路徑

從專業發展的 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 建置外掛程式

將成品與其發佈路由進行比對

請遵循成品的發佈指引:

支援一個成品並不會建立每個外掛程式套件的發佈資格。 發行未完成使用者存取、同意或連線設定。

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。

實作技能

完成適用的工作:

  1. 定義作業、輸入、預期輸出、界限和成功準則。
  2. 建立或匯入技能指示。
  3. 新增必要的支援資源和指令碼。
  4. 設定任何必要的工具、遠端 MCP 伺服器、API、身分識別、權限或資料相依性。
  5. 確認支援的檔案類型、指令碼類型、沙箱行為、儲存空間和敏感度需求。
  6. 測試預期、不明確、不支援和失敗案例。
  7. 記錄技能版本、擁有者、相依性、已知限制和支援程序。

如需直接在 Copilot Chat 中使用的技能,請參閱組建 Copilot Chat 的技能。 如需宣告式代理程式的目前支援及執行階段限制,請參閱 宣告式代理程式的技能。 若為 Copilot Cowork,請參閱隨附檔案限制。 當您將技能散發給多個體驗時,套用每個目標主機的需求。

確認該技能可正常使用

在下列情況下,技能已準備好整合:

  • 目標代理程式或體驗可以載入並使用它。
  • 其指令會一致地執行定義的工作。
  • 必要的資源、指令碼、工具和資料可供使用。
  • 權限和外部相依性適用於開發或測試環境。
  • 不受支援或失敗的作業會產生可理解的行為。
  • 所有權、版本設定、限制和測試證據都會被記錄下來。

繼續進行計劃中的任何其他元件。 完成後, 請整合並測試您的元件,然後移至 [套件 & 測試 ] 以 建立外掛程式套件。