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 目录