Teams 应用开发助手
用 ATK 构建、测试并部署 Teams 与 Microsoft 365 智能体。
明确要求不硬编码秘密、缺失配置时询问用户，并警示部分操作具有破坏性；但部署、Azure 资源供应、文件移动和遥测标记等外部影响缺少逐步确认、最小权限说明、数据流披露和回滚方案，因此扣分。
包含工作流路由、长命令等待、后台进程规则、常见错误诊断和失败后的重启建议，提升了可操作性；但本次未执行，关键路径没有在所给材料中得到运行复现，部分代码和平台断言仍需验证，异常输入与失败反馈覆盖有限，因此扣分。
目标用户、适用场景和不适用范围写得清楚，且提供 Teams、Copilot、Slack 迁移等触发线索；但范围极宽，非适用边界和语义触发条件仍不够细，未提供中文使用指导，并依赖 Microsoft Teams、Azure、Dev Tunnels 等环境，对中国大陆网络可达性未说明，因此扣分。
信息架构较清晰，采用主技能、子技能、共享参考和工作流链路渐进组织；有 CLI 版本要求、示例、限制提示和仓库 MIT 元数据，但技能自身缺少明确版本号、变更记录、维护责任与更新路径，且依赖文档是否完整可达未被充分说明，因此扣分。
能够覆盖项目创建、测试、部署、排障以及 Slack-to-Teams 迁移，并给出大量可直接参考的命令、映射和代码模式；但静态材料无法证明命令和示例可运行，复杂场景仍需人工设计、权限配置和验证，直接可用性证据有限，因此扣分。
所给文件包含可审计的命令、代码、限制说明，并提及确定性模式评估、路由和完整性评估；但未提供实际 CI 工作流、测试套件或第三方执行结果，本次也未执行任何内容，因此只能给予较低分。
- 执行任何 atk provision 或 atk deploy 前，应明确确认 Azure 资源、权限、成本和目标环境，并准备可回滚方案。
- telemetry tagging 会向 CLI 传递技能来源标记；应确认组织遥测政策和数据流要求。
- 文档覆盖面很广，但示例未在本次静态审查中运行；应先核验 CLI 版本、SDK API、Adaptive Card 结构和 Graph 权限。
- Teams、Azure、Bot Framework、Dev Tunnels 等核心依赖的中国大陆网络可达性、租户限制和许可证要求未说明。
它能做什么 & 适用场景
这是一个面向 Microsoft 365 Agents Toolkit CLI 的开发技能，服务于 Teams 应用和 Copilot 智能体。它覆盖项目创建、本地测试、Azure 资源预配、云端部署、故障排查以及 Slack 到 Teams 迁移。技能明确建议优先使用 Agents Playground 进行本地测试，并要求在执行具体工作流前阅读对应子技能文档。它适合已经使用或准备使用 Teams、Copilot 和 ATK 的开发者，不适合通用 Web 开发或非 Teams 项目。
指导用户检查或安装 ATK CLI，设置 ATK_CLI_SKILL 环境变量，使用 atk new、atk provision 和 atk deploy 等命令创建、预配和部署项目；指导启动本地服务、使用 Agents Playground 或 Teams 进行测试、监控后台日志，并检查 env/.env.local、.localConfigs 和 atk auth list。它还根据错误信息定位常见问题，例如 AADSTS7000229、缺少 TENANT_ID、Bot Connector 返回 401，以及可能需要重新创建的 devtunnel。
- Teams 开发者需要从模板创建新的 Teams 应用或智能体，并进行本地验证。
- Copilot 开发者希望使用 Agents Playground 快速测试现有项目，而不依赖 Microsoft 365。
- Azure 开发者需要为 Teams 或 Microsoft 365 应用预配资源并执行远程部署。
- 维护 Bot 的工程师遇到身份验证、YAML、端口或过期 Bot 问题，需要按诊断步骤排查。
- Slack Bot 开发者需要迁移到 Teams，或将 Block Kit 转换为 Adaptive Cards。
优缺点一览
- 覆盖从项目创建、本地测试到 Azure 部署的完整 Teams 开发流程。
- 包含 Agents Playground 优先的测试策略和具体故障排查线索。
- 同时支持 Teams 应用、Copilot 智能体及 Slack 到 Teams 迁移场景。
- 明确要求不要硬编码秘密或虚构环境变量值。
- 依赖 Microsoft 365 Agents Toolkit CLI、shell 和本地文件配置。
- 具体工作流依赖未随提示提供的子技能文档，当前资料无法核实其完整步骤。
- 源材料没有提供该单项技能的独立测试覆盖或平台兼容性结果。
- 不面向通用 Web 开发或非 Bot、非 Teams 项目。
如何安装
使用集合安装命令：npx skills add microsoft/skills。根据向导选择需要的技能；技能会安装到所选 Agent 的目录，例如 GitHub Copilot 使用 .github/skills/。本技能位于 .github/plugins/microsoft-365-agents-toolkit/skills/teams-app-developer/SKILL.md。若 ATK CLI 未安装或版本不高于 1.1.5-beta，可执行 npm i -g @microsoft/m365agentstoolkit-cli@beta。
如何使用
用类似“为我创建一个 Teams 智能体并先在 Agents Playground 中测试”或“排查这个 Teams Bot 的 401 错误”的请求触发。执行工作流前，先阅读对应子技能文档；运行任何 atk 命令前设置 export ATK_CLI_SKILL=true。对 atk new、atk provision 和 atk deploy 等长时间命令等待完成；对 npm run dev、npm start、python app.py 和 devtunnel host 等持续运行的服务使用后台进程，并在新终端启动 Agents Playground 或 Teams 测试。
对比同类
技能将 Agents Playground 与 Teams 工作流区分开来：前者被建议作为更快、无需 Microsoft 365 的首选本地测试方式；只有用户明确要求时才使用 Teams 工作流。