M365 Agents Toolkit 安装助手
用标准化命令安装或更新 M365 Agents Toolkit CLI 与 VS Code 扩展。
技能明确要求设置 ATK_CLI_SKILL=true，并公开使用 npx 下载 @microsoft/m365agentstoolkit-cli 及安装 VS Code 扩展；但未要求用户在执行外部下载和扩展安装前确认，也未说明网络、遥测数据流、权限范围或卸载/回滚方法。MIT 许可和 Microsoft 来源提供归属证据，但不足以弥补供应链与外部副作用控制缺口，因此扣分。
命令、意图映射和失败时检查 Node.js 18+、npm 的路径清楚，并要求报告失败；但没有锁定 CLI 版本、验证扩展安装结果、处理 npx/code 不存在或网络失败的诊断细节，也没有针对该技能的执行测试证据。静态上限下给予中等分数并扣除边界处理分。
触发短语和 CLI/扩展/全部安装场景较明确；但未声明不适用范围、平台限制、输入输出格式或非交互环境行为。核心功能依赖 npm registry、npx 和 VS Code Marketplace，文件未证明其在中国大陆网络环境可达，因此扣分。
结构包含触发器、行为表、命令、执行步骤和安全规则，易于快速使用；但缺少版本策略、变更记录、维护责任、依赖兼容矩阵、卸载说明、FAQ 和已知限制。仓库提供 MIT 许可证、官方组织归属和 CI/评估信号，但这些不能替代技能级维护信息。
对安装或更新 ATK CLI/VS Code 扩展的核心任务给出了可直接复制的命令，并区分了用户意图；但只验证 CLI 版本，扩展安装缺少结果校验，默认安装最新版可能引入不确定性，失败后的恢复仍需用户处理，因此只能评为基本有效。
命令和预期成功/失败行为可由读者审计，仓库还有通用 CI 与测试材料；但提供的证据未覆盖该 install-atk 技能的关键路径，也没有提交的专用验收测试、第三方执行记录或版本化结果。静态评估且无证据 URL，因此仅给有限分数。
- 执行前应明确征得用户同意，因为 npx 会下载并运行最新版 CLI，code 命令会修改本地 VS Code 扩展环境。
- 未说明遥测变量 ATK_CLI_SKILL=true 会记录或传递哪些数据。
- 未提供版本锁定、扩展安装验证、卸载或回滚步骤。
- npm registry 和 VS Code Marketplace 的可达性及镜像配置未说明，可能影响中国大陆用户。
它能做什么 & 适用场景
install-atk 是一个用于安装或更新 M365 Agents Toolkit（ATK）CLI 和 VS Code 扩展的 Agent Skill。它根据用户意图判断应安装 CLI、扩展，还是两者都安装。CLI 通过 npx 自动下载并运行最新版本，无需全局安装。安装 CLI 前，Skill 会设置 ATK_CLI_SKILL 环境变量，以标记后续 CLI 调用。
在运行任何 atk CLI 命令前设置 ATK_CLI_SKILL=true；使用 npx -y --package @microsoft/m365agentstoolkit-cli atk --version 验证 ATK CLI；在用户请求扩展或 VSIX 时运行 code --install-extension TeamsDevApp.ms-teams-vscode-extension；报告 CLI 版本或失败信息，并说明 npx 命令前缀的使用方式。
- 需要开始使用 M365 Agents Toolkit 的开发者，希望同时配置 CLI 和 VS Code 扩展。
- 只想确认 ATK CLI 是否可用的开发者。
- 需要更新 ATK CLI，而不希望进行全局 npm 安装的开发者。
- 需要安装或更新 ATK VS Code 扩展或 VSIX 的开发者。
优缺点一览
- 同时覆盖 ATK CLI 与 VS Code 扩展安装和更新场景。
- 使用 npx 自动下载并运行最新 CLI，无需全局安装。
- 明确要求报告版本或失败原因，并检查 Node.js 与 npm。
- 通过 ATK_CLI_SKILL=true 标记由 Skill 发起的 CLI 调用。
- 依赖 Node.js 18+、npm 和可用的 npx 环境。
- 扩展安装依赖已安装并可调用的 VS Code code 命令。
- 源材料未说明不同操作系统、权限配置或代理环境下的兼容性。
- README 的测试覆盖摘要未明确列出 install-atk 的专属测试。
如何安装
先安装整个技能集合：运行 npx skills add microsoft/skills，并在向导中选择需要的技能。技能会安装到所选 Agent 的目录，例如 GitHub Copilot 使用 .github/skills/。源材料未提供单独安装 install-atk 技能的命令。
如何使用
向 Agent 输入“install atk”“update atk”“install agents toolkit”“install atk cli”或“install atk extension”等请求。CLI 验证使用 npx -y --package @microsoft/m365agentstoolkit-cli atk --version；扩展安装使用 code --install-extension TeamsDevApp.ms-teams-vscode-extension。所有后续 atk 命令都应使用该 npx 前缀。