SkillsScout
INTEGRATION-WORKFLOW ／ 集成与工作流自动化

declarative-agent-developer-microsoft-skills

收录日期 2026-08-06·来源仓库 ↗
受欢迎程度
7
可用程度与相关性
8
安全性
8
7.7SCOUT SCORE

1. 基本信息

项目 内容
名称 declarative-agent-developer-microsoft-skills
作者/维护者 Microsoft（官方仓库 microsoft/skills，microsoft-365-agents-toolkit 插件）
来源链接 https://github.com/microsoft/skills/tree/main/.github/plugins/microsoft-365-agents-toolkit/skills/declarative-agent-developer
许可证 MIT（数据来自仓库根 LICENSE 文件与 GitHub API）
GitHub Stars 合集仓库整体 2,863（数据来自 GitHub API，2026-08-06）；该数字属整个 microsoft/skills 仓库，不代表本技能自身热度
Forks 合集仓库整体 323（数据来自 GitHub API）
最新版本 插件 manifest 声明 1.3.1（.claude-plugin/plugin.json）
安装方式 GitHub Copilot CLI 插件市场一条命令安装；其他兼容 Agent Skills 规范的工具（含 Claude Code）克隆仓库后复制或软链整个技能目录

2. 功能介绍与亮点

declarative-agent-developer 覆盖“为 M365 Copilot 与 Teams 构建声明式智能体（Declarative Agent）“这件事的完整生命周期：新建项目脚手架、编辑 JSON 清单、添加能力/API 插件/MCP 插件、配置 OAuth 鉴权、多语言本地化、审查并改进智能体指令质量、部署上线。技能内部按场景拆成 13 篇独立参考文档（脚手架、清单编辑、API 插件、MCP 插件、鉴权、本地化、部署、对话设计、指令质量审查、Schema 版本矩阵等），主文件本身只负责路由到对应文档，避免一次性塞给使用者过多内容。

最突出的亮点是一套写得极具体的“硬性拒绝规则”：清单缺失时绝不擅自新建文件、清单有错时绝不允许部署、遇到任何问题必须先“侦测→告知→询问”再动手，不允许静默修复或臆造占位值；新增能力后强制要求同步更新智能体指令与对话开场白，避免“功能加了但用户根本不知道能怎么问”。这套约束把“AI 帮你搭智能体时最容易出的错”直接写死在流程里，而不是依赖使用者自己发现问题。

3. 适用场景

所属分类：集成与工作流自动化

4. 跨 Agent 兼容性

5. 推荐理由

搭建一个能上架 M365 Copilot 的智能体，涉及 JSON 清单格式、能力配置、插件鉴权、多语言本地化等一整套官方规范，过去只能靠翻查微软文档或反复试错。这个技能把该流程收敛成有明确入口、有失败兜底的结构化路径：新建、编辑、加插件、本地化、审查指令质量、部署，每一步都路由到对应参考文档，且对“清单缺失时该不该自己建文件”“有错时该不该硬着头皮部署”这类容易踩坑的判断给出了明确的拒绝规则，减少了 AI 自作主张搞坏用户项目的风险。

6. 评分

维度 分数 说明
受欢迎程度 7 Microsoft 官方仓库出品；该子目录本身仅 1 次同步提交，未检索到独立第三方 issue/PR 讨论，热度主要来自官方身份与母仓库持续活跃（2026-08-05 仍有推送）
可用性 8 13 篇参考文档覆盖每个使用场景，路由清晰；本地脚手架与清单编辑无需额外账号即可上手，但完整部署与真机测试仍需 M365 租户及 Copilot 许可证
安全性 8 见下方检查清单，无一票否决因素；有真实 CLI 执行与云端部署，权限范围比纯文本类技能更广，但配有目前记录中少见的显式硬性拒绝规则约束风险面
综合 7.7 三项均值

安全检查清单：① Shell 命令——执行 atk CLI 完成脚手架、加插件、部署，命令范围严格限定在智能体项目文件与 ATK 官方操作内；② 联网外发——部署阶段连接 Azure/M365 服务，添加 MCP 插件时会与用户指定的 MCP Server 做协议握手发现工具列表，目标均由用户或官方平台指定，未见隐蔽外发；③ API Key/凭据——OAuth 鉴权信息据文档要求绝不使用占位值，缺失时必须询问用户真实值；④ 可疑指令——通篇为结构化的“侦测→告知→询问”安全协议与硬性拒绝规则，未见提示注入或隐蔽越权迹象；⑤ 作者信誉——Microsoft 官方仓库；⑥ License——MIT，明确；⑦ 最近维护——母仓库 2026-08-05 仍有推送，插件版本 1.3.1。

7. 跟同类 Skills 相比的优势

对比对象 定位 与 declarative-agent-developer 的差异
teams-app-developer-microsoft-skills（同仓库姊妹技能） 面向 Teams/M365 应用的整个开发生命周期——建项目外壳、本地测试、真机侧载、部署、故障排查，外加 Slack 迁移 定位更宽泛、覆盖应用外壳与测试环境搭建；declarative-agent-developer 则专注智能体本身——清单编辑、能力/插件配置、指令质量审查与多语言本地化，二者互补而非替代
agents-cli（google/agents-cli，Google ADK 官方套件） 面向 Google Cloud 上用编码 Agent 构建、评测、部署、观测 AI 智能体的全生命周期工具集 服务对象是 Google ADK/Gemini 生态而非 M365 Copilot，同属“官方智能体构建工具链”这一类型，但落地平台与清单格式完全不同

8. 用户评价

该技能所在的 microsoft-365-agents-toolkit 插件由 Microsoft 内部工程师提交并持续同步，目前尚未检索到聚焦该技能本身的具名第三方用户评价或第三方 issue 讨论。

9. 其他补充

同一插件下还有 install-atk（安装/更新 ATK CLI 与 VS Code 扩展）、m365-agent-evaluator（生成并分析智能体评测集）、ui-widget-developer（为 Copilot Chat 构建带交互组件的 MCP Server）等技能，与 teams-app-developer 一起构成“建智能体 → 建应用外壳 → 测评 → 建富交互组件”的更完整流程。

10. 安装使用方式

GitHub Copilot CLI 插件市场（官方原生渠道）：

/plugin install microsoft-365-agents-toolkit@work-iq

其他兼容 Agent Skills 规范的工具（含 Claude Code 手动安装）：本技能由 SKILL.md 主文件与 references/ 目录（13 篇参考文档）共同组成，需完整复制才能使用全部功能：

git clone https://github.com/microsoft/skills.git
cp -r skills/.github/plugins/microsoft-365-agents-toolkit/skills/declarative-agent-developer your-project/.claude/skills/

使用前需能运行 npx -y --package @microsoft/m365agentstoolkit-cli atk（无需全局安装，npx 自动下载）。安装后无需重启 Agent；本地脚手架与清单编辑无需 M365 租户即可进行，若要实际部署并在 M365 Copilot 中测试，需另行准备 M365 租户与 Copilot 许可证。

11. 注意事项