1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | teams-app-developer-microsoft-skills |
| 作者/维护者 | Microsoft(官方仓库 microsoft/skills;该子技能由工程师 qfai 提交新增,Larry Osterman 参与后续 CI 测试修复) |
| 来源链接 | https://github.com/microsoft/skills/tree/main/.github/plugins/microsoft-365-agents-toolkit/skills/teams-app-developer |
| 许可证 | MIT(数据来自 GitHub API 与仓库根 LICENSE 文件) |
| GitHub Stars | 合集仓库整体 2,819(数据来自 GitHub API,2026-07-26);该数字属整个 microsoft/skills 仓库,不代表本技能自身热度 |
| Forks | 合集仓库整体 317(数据来自 GitHub API) |
| 最新版本 | 插件 manifest 声明 1.3.1(.claude-plugin/plugin.json) |
| 安装方式 | GitHub Copilot CLI 插件市场一条命令安装;其他兼容 Agent Skills 规范的工具(含 Claude Code)可克隆仓库后复制整个技能目录 |
2. 功能介绍与亮点
teams-app-developer 面向“用 Microsoft 365 Agents Toolkit(ATK)CLI 构建、测试、部署 Teams 与 M365 智能体应用”这一完整生命周期,覆盖 Bot、Tab、Message Extension、声明式智能体(Declarative Agent)、自定义引擎智能体(Custom Engine Agent)等多种项目形态。技能内部拆成 6 个子模块,各自有独立文档:create-project(脚手架建新项目)、test-playground(无需接入真实 M365 租户即可快速本地测试)、test-teams(devtunnel + 真实 Teams 环境侧载测试)、provision-deploy(Azure 资源开通与部署)、troubleshoot(常见错误诊断,如 Azure AD 报错 AADSTS7000229、Bot Connector 401 等)、以及 slack-to-teams(把已有 Slack 机器人迁移到 Teams,含 Slack Block Kit 到 Teams Adaptive Cards 的格式转换)。此外还附带 100 余篇按主题细分的参考文档(Teams SDK、Slack SDK、跨平台桥接、部署、AI 模型、安全、语言转换等),以及一组“UI/消息/身份/基础设施/能力差异”平台对比说明。
最突出的亮点是一套写得很具体的“AI 行为准则”:本地长驻服务(npm run dev、devtunnel host 等)必须以后台进程方式启动、绝不能等待其“运行结束”;atk new/atk provision/atk deploy 等长耗时命令必须等待完成再继续;环境变量与密钥严禁硬编码或臆造占位值,缺失时必须向用户询问真实值。这类细节把“容易踩坑的地方”直接写进了技能指令里,而不是留给使用者自己试错。
3. 适用场景
所属分类:集成与工作流自动化
- 需要为 Teams 或 M365 Copilot 构建 Bot、Tab、Message Extension 或声明式智能体的开发者
- 想先用 Agents Playground 快速本地验证智能体行为、暂不接入正式 M365 租户的团队
- 需要把智能体部署到 Azure、并处理资源开通与鉴权配置的工程师
- 已有 Slack 机器人、希望迁移到 Teams 平台并转换消息卡片格式的团队
4. 跨 Agent 兼容性
- Claude Code:SKILL.md 遵循通用 Agent Skills 规范(YAML front matter + Markdown 指令);仓库官方安装工具
npx skills add microsoft/skills的说明中明确演示了将技能软链接进.claude/skills目录——判定为原生支持。 - GitHub Copilot CLI:官方原生渠道,README 直接给出插件市场安装命令。
- Codex / OpenClaw / Hermes Agent:未验证。README 与 SKILL.md 均未提及针对这三者的专门测试或安装说明。
5. 推荐理由
它把“给 Teams/M365 写一个智能体应用”从分散在官方文档、Stack Overflow 和踩坑经验里的零碎知识,收敛成一套结构化的开发流程:建项目、本地测试、部署上线、排障、迁移,每一步都有对应文档且互相引用清楚该走哪条路径。对刚接触 M365 Copilot 生态的开发者来说,最大的价值是把认证报错、devtunnel 失效、后台进程管理这类新手最容易卡住的地方提前写成了可查的故障排查表;对已经在用 Slack 机器人的团队,slack-to-teams 提供了一条其他同类工具都没有覆盖的现成迁移路径。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Microsoft 官方仓库出品;该子目录本身提交记录较少(新增 + 一次 CI 修复,均为具名工程师),未检索到独立第三方 issue/PR 讨论,热度主要来自官方身份与母仓库持续活跃(2026-07-24 仍有推送),而非该子目录自身的社区声量 |
| 可用性 | 8 | 文档体系完整(6 个子模块 + 100 余篇细分参考文档),设置门槛清晰(需安装 ATK CLI,版本号有明确检查要求);本地测试路径(Agents Playground)无需 M365 租户即可上手,但完整部署仍需 Azure 账号与租户配置 |
| 安全性 | 8 | 见下方检查清单,无一票否决因素,但涉及真实云资源部署,权限范围比纯文本类技能更广 |
| 综合 | 7.7 | 三项均值 |
安全检查清单:① Shell 命令——执行 atk/npm/devtunnel 等命令,包括创建项目、开通 Azure 资源、部署应用,权限范围较广但均服务于“构建并上线一个 Teams/M365 应用”这一明确目的;② 联网外发——部署阶段会连接 Azure 与 Bot Connector 服务,devtunnel 会将本地端口临时暴露到公网用于 Teams 侧载测试,用途在文档中说明清楚;③ API Key/凭据——需要 Azure OpenAI Key、租户 ID 等,SKILL.md 明确写明“绝不硬编码或臆造占位值,缺失时必须询问用户”;④ 可疑指令——指令要求执行前设置环境变量 ATK_CLI_SKILL=true,用于将后续 CLI 调用标记为“由本技能发起”,该行为在文本中公开声明,未见隐蔽外发或越权访问的迹象;⑤ 作者信誉——Microsoft 官方仓库,具名工程师维护;⑥ License——MIT,明确;⑦ 最近维护——该子目录最近一次改动为 CI 测试修复,母仓库 2026-07-24 仍有推送。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 teams-app-developer 的差异 |
|---|---|---|
| slack-skills-plugin(Slack 官方出品) | 让 Claude Code 直接搜索 Slack 消息、发布频道公告,聚焦“日常使用 Slack”这一单一平台 | 只服务 Slack 平台内的操作,不涉及构建/部署应用,也没有跨平台迁移能力 |
| copilot-sdk-microsoft-skills(同仓库姊妹技能) | 面向已在用 Claude Code/Codex 等编程 Agent、想把可编程智能体能力嵌入自己产品的开发者,是更底层的 SDK 集成向导 | 定位更通用、不绑定 Teams/M365 平台;teams-app-developer 则专注 Teams/M365 这一具体应用形态的建站、测试、部署、排障全流程,并额外覆盖 Slack 迁移场景 |
8. 用户评价
该技能所在的 microsoft-365-agents-toolkit 插件于 2026-06-15 新增、2026-06-20 有过一次 CI 测试修复,均由 Microsoft 内部工程师提交;目前尚未检索到聚焦该技能本身的具名第三方用户评价或第三方 issue 讨论。
9. 其他补充
同一 microsoft-365-agents-toolkit 插件还包含 declarative-agent-developer(声明式智能体的脚手架、清单编写与本地化)、install-atk(安装/更新 ATK CLI 与 VS Code 扩展)、m365-agent-evaluator(生成并分析智能体评测集)、ui-widget-developer(为 Copilot Chat 构建带交互组件的 MCP Server)等技能,组合起来覆盖了“建智能体 → 建应用外壳 → 测评 → 建富交互组件”的更完整流程。
10. 安装使用方式
GitHub Copilot CLI 插件市场(官方原生渠道):
/plugin install microsoft-365-agents-toolkit@work-iq
其他兼容 Agent Skills 规范的工具(含 Claude Code 手动安装):本技能由 SKILL.md 主文件与 create-project/、test-playground/、test-teams/、provision-deploy/、troubleshoot/、slack-to-teams/、toolkit/、experts/、docs/ 等多个子目录共同组成,需克隆整个仓库后复制完整目录,仅拷贝单一 SKILL.md 文件无法使用完整功能:
git clone https://github.com/microsoft/skills.git
cp -r skills/.github/plugins/microsoft-365-agents-toolkit/skills/teams-app-developer your-project/.claude/skills/
使用前需安装 ATK CLI(npm i -g @microsoft/m365agentstoolkit-cli@beta,要求版本高于 1.1.5-beta)。安装后无需重启 Agent;本地测试(Agents Playground)无需 M365 租户即可运行,若要在真实 Teams 环境测试或部署到 Azure,需另行准备 M365 租户与 Azure 订阅。
11. 注意事项
- 完整部署链路(
provision-deploy)需要 Azure 订阅与 M365 租户,并非零门槛开箱即用,前期探索建议优先用 Agents Playground - 技能会要求在执行
atk命令前设置环境变量ATK_CLI_SKILL=true,用于向 Microsoft 标记该次 CLI 调用由本技能发起;该行为在文档中公开说明,但对遥测敏感的用户可留意 - 版本号仅见于插件 manifest(1.3.1),仓库未见对应的正式 GitHub Release,版本追溯需以提交历史为准
- 技能明确声明不适用于一般性 Web 开发或非 Bot/非 Teams 类项目,选型前应先确认场景匹配