C✳CODEZ.WIN
🌐 繁體中文

Skill 多語言閱讀指南

declarative-agent-developer用途、用法與原始來源

為 M 建立、建置、部署和本地化聲明式代理365Copilot 和 Teams。此技能可用於任何涉及聲明式代理的任務，包括在地化、建造鷹架、編輯清單、新增功能和部署。在地化需要標記化的清單和語言文件，而只有此技能才能產生這些文件。觸發器：“創建代理”、“創建聲明式代理”、“新建聲明式代理”、“搭建代理腳手架”、“新建代理項目”、“添加功能”、“添加插件”、“配置我的代理”、“部署我的代理”、“修復我的代理清單”、“編輯我的代理”、“本地化我的代理”、“添加本地化”、“翻譯我的代理”、“多語言代理”、“添加 API 插件”、“添加 MCP插件」、「為我的插件添加 OAuth」、「審核說明」、「改進說明」、「修復我的說明」。

原文擷取時間:

來源儲存庫
microsoft/skills
SKILL.md
.github/plugins/microsoft-365-agents-toolkit/skills/declarative-agent-developer/SKILL.md
儲存庫 Star
3,157
儲存庫最近更新
2026-10-31
能力分類
Agent 工作流程
最近採集時間

授權：MIT

原始 SKILL.md

流程片段用來協助閱讀上游說明。本頁沒有執行第三方 Skill，不屬於實測評測。

下面的用途與操作片段來自上游文件，由本站整理並翻譯，和另行標示的 Codez 編輯分析分開呈現。

這個 Skill 能做什麼

為 M 建立、建置、部署和本地化聲明式代理365Copilot 和 Teams。此技能可用於任何涉及聲明式代理的任務，包括在地化、建造鷹架、編輯清單、新增功能和部署。在地化需要標記化的清單和語言文件，而只有此技能才能產生這些文件。觸發器：“創建代理”、“創建聲明式代理”、“新建聲明式代理”、“搭建代理腳手架”、“新建代理項目”、“添加功能”、“添加插件”、“配置我的代理”、“部署我的代理”、“修復我的代理清單”、“編輯我的代理”、“本地化我的代理”、“添加本地化”、“翻譯我的代理”、“多語言代理”、“添加 API 插件”、“添加 MCP插件」、「為我的插件添加 OAuth」、「審核說明」、「改進說明」、「修復我的說明」。

如何使用：上游操作流程

⛔ 工作區檢查 — 強制性第一步

在執行任何操作之前，請檢查工作區檔案以取得專案指紋：執行npx -y --package @microsoft/m365agentstoolkit-cli atk --version確認 ATK CLI 已安裝。如果未找到 → 停止。告知使用者安裝 ATK。檢查m365agents.yml或者teamsApp.yml在專案根目錄下。檢查以下內容appPackage/declarativeAgent.json。

原文片段 · L26 ↗

6更改後務必更新說明和啟動器

添加功能或插件而不更新說明是不完整的。任何更改後：更新說明以描述該更改。new/changed功能性－根據指令審查品質標準，每個資料來源都應有清晰的意圖說明（何時以及為何使用它）。內建功能不需要完全相同的名稱；actions/plugins應該命名。請勿在說明中列出工具名稱、描述或參數－這些資訊已包含在插件元資料中（ai-plugin.json（MCP清單、功能配置）。指令應僅包含決策邏輯：何時使用每個工具、鍊式規則和故障處理。至少添加1每增加一個對話開場白capability/plugin

原文片段 · L158 ↗
原文片段 · bash ↗
export ATK_CLI_SKILL=true

環境與相依需求

ATK CLI 設定

在執行任何 ATK 命令之前，請執行以下命令檢查 ATK CLI 是否可用：npx -y --package @microsoft/m365agentstoolkit-cli atk --version如果未找到，請停止並告知使用者—請勿嘗試自行安裝。所有指令均使用npx -y --package @microsoft/m365agentstoolkit-cli atk前綴（例如，npx -y --package @microsoft/m365agentstoolkit-cli atk provision --env local）。

原文片段 · L91 ↗

3. 模式版本相容性

在添加任何功能之前，請閱讀以下內容：version領域declarativeAgent.json並檢查架構功能矩陣。如果該功能在該版本中不受支持，則拒絕並提供升級選項。關鍵版本控制點：

原文片段 · L131 ↗

限制與結果檢查

2切勿捏造內容或創建缺失的文件

請勿自行編造佔位符名稱、描述或說明。請勿創建declarativeAgent.json或者appPackage/如果它們不存在——這是拒絕的情況，而不是「透過創建來提供幫助」的情況。

原文片段 · L123 ↗

4。 使用npx -y --package @microsoft/m365agentstoolkit-cli atk add action對於 API 插件—切勿手動建立插件文件

您不得手動創建ai-plugin.jsonOpenAPI規格、自適應卡或編輯actions數組。使用 CLI：運行單個npx -y --package @microsoft/m365agentstoolkit-cli atk add action根據 OpenAPI 規範進行調用，將所有操作列為以逗號分隔的清單。--api-operation切勿單獨運行npx -y --package @microsoft/m365agentstoolkit-cli atk add action同一規範中對不同操作的呼叫——這將創建多個插件而不是一個。如果npx -y --package @microsoft/m365agentstoolkit-cli atk add action如果失敗，請報告錯誤；不要回退到手動建立。

原文片段 · L141 ↗

開始使用前

  1. 先核對支援的 Agent 宿主和儲存庫安裝說明。保留完整 Skill 目錄及其引用的腳本、資源和文件，只複製 SKILL.md 可能遺漏相依需求。
  2. 向 Agent 提供實際輸入、預期輸出和驗收標準。呼叫方式與可用工具取決於宿主環境，本站不假定存在通用的安裝指令。
  3. 先在暫存專案或輸入副本上試用。涉及修改檔案、遠端服務或計費資源的操作，應逐項核對後再授權。
  4. 依照原文檢查項目和自己的需求驗證輸出。成功觸發或儲存庫 Star 較高，都不能證明結果正確。

Skill 檔案與目錄格式規範 ↗

繼續閱讀原始文件

翻譯與介紹範圍

本頁從固定版本的上游 SKILL.md 整理用途與操作片段，譯文使用輔助翻譯。它不是完整手冊，也不代表經過相容性實測；使用前請核對原文及其引用檔案。

介紹依據下方列出的固定版本；目前儲存庫動態和目錄擷取時間分開呈現。

固定版本來源
閱讀原文 ↗
原文擷取時間
來源提交版本
00d66a64919edca5bca2c673373444e36a4b5461
原文 SHA-256
13d2af8dd44cca049c8ebf8a8880cca304fc3dc419c926ef146dba35b14df412
返回完整 Skill 目錄