🔍 插件简介

implement 是 Azure-Samples/Spec2Cloud 项目中的一项核心技能，专门用于根据已有的规划文档自动生成应用源代码和基础设施即代码。它是连接规划与部署之间的桥梁，让 AI 助手在你确认计划后直接开始写代码。

⚙️ 主要功能一览

这个插件解决的是从规划到代码的最后一公里问题。当你的 spec.md 和 plan.md 就绪后，它负责把纸面上的计划变成实际可运行的代码。

代码生成
  • 根据 plan.md 生成应用源代码
  • 自动创建和更新基础设施代码
  • 支持并行加速多个任务
环境搭建
  • 自动执行 azd init 初始化项目
  • 持久化部署所需的环境变量
  • 配置 azure.yaml 服务定义
质量检查
  • 验证前后端 CORS 配置
  • 检查容器镜像构建设置
  • 确认 Foundry 代理端点配置
文档同步
  • 创建 implementation.md 记录实际架构
  • 生成 Mermaid 流程图可视化数据流
  • 追踪与 plan.md 的偏差

📦 第一次安装：一行命令

安装前确认环境就绪：Node.js 18+ 已装好、Azure CLI 已登录、Azure Developer CLI 已通过 azd auth login 认证。

通用安装命令：

npx skills add https://github.com/Azure-Samples/Spec2Cloud --skill implement

执行后会提示你选择目标 AI 编程环境，选中后回车即可完成安装。

💡 小提示：这个技能依赖 spec.md 和 plan.md 文件。如果它们不存在，插件会自动运行 specify 和 plan 技能来生成，然后才开始执行。

🚀 安装后怎么用：直接说话就行

这个插件不需要你记复杂命令。安装完成后，在 AI 助手的对话窗口里直接用自然语言描述需求，它会自动识别并激活技能。比如：

“根据规划文档实现这个应用”

插件会按照以下流程自动执行：

  • 加载上下文：读取 spec.md 和 plan.md，了解项目需求
  • 搭建脚手架：如果 infra 目录缺失，自动执行 azd init 初始化项目
  • 持久化环境变量：确保 deployment-plan.md 中没有未解决的标记
  • 执行实现：按照 plan.md 逐步生成代码，支持并行加速
  • 执行后检查：验证 CORS、容器配置、Foundry 端点等关键设置
  • 报告结果：汇总 architecture、关键决策和与计划的偏差

如果你想手动验证项目状态，可以检查以下文件：

# 查看实现文档
cat ./docs/implementation.md

# 查看部署计划
cat ./.azure/deployment-plan.md

# 查看 azure.yaml 服务配置
cat ./azure.yaml

🎯 主要应用场景

从规划到代码的自动落地 当你完成 spec 和 plan 文档后，用这个技能直接生成可运行的应用代码和 IaC 配置，省去手动搭建项目结构的时间。
多服务项目快速搭建 需要同时创建前端、后端、MCP 服务器和 AI 代理时，插件会并行处理多个任务，大幅缩短项目初始化时间。
Azure 容器应用部署准备 自动配置 ACR 镜像仓库、设置远程构建、验证 CORS 跨域策略，确保项目具备部署到 Azure 的条件。
Foundry 代理集成 为 Microsoft Foundry 托管的 AI 代理配置专用端点，使用 DefaultAzureCredential 进行认证。

🔧 使用技巧与帮助

先检查 plan.md 的完整性。开始实现前，确保 deployment-plan.md 中没有 [NEEDS CLARIFICATION: ...] 标记，否则插件会暂停等待你补充信息。

中断后可以继续。如果实现过程被中断，重新触发技能后它会自动读取 plan.md，从下一个未完成的步骤继续执行。

保持共享契约一致。多个代理并行工作时，确保 API 定义、环境变量名和 azure.yaml 服务名称保持一致。

配合 azure-validate 和 azure-deploy 使用。实现完成后，先用 azure-validate 验证配置，再用 azure-deploy 执行实际部署，形成完整的工作流。

💡 触发关键词：在对话中提到“实现应用”“生成代码”“根据规划创建项目”“搭建基础设施”等词，插件会自动激活。

🤖 适配哪些 AI 工具

implement 作为 Spec2Cloud 技能包的一部分，支持多种 AI 编程环境。只要你的助手支持 Skills 或 MCP 协议，基本都能用。

GitHub Copilot CLI VS Code Claude Code Cursor Codex CLI IntelliJ IDEA Gemini CLI

如果你用的工具支持加载自定义 Skill 文件，也可以手动配置使用。安装命令中的 npx skills add 方式适用于大多数环境。