1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | import-infrastructure-as-code-github-awesome-copilot |
| 作者/维护者 | github/awesome-copilot(社区共建 Agent Skills 合集仓库,由贡献者 Anders Eide 提交并经仓库维护流程合并) |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/import-infrastructure-as-code |
| 许可证 | MIT(GitHub API 数据) |
| GitHub Stars | 合集仓库整体 39,610(GitHub API);属整个合集,不代表本技能自身热度 |
| Forks | 合集仓库整体 5,044,同上,不代表本技能个体热度 |
| 最新版本 | 不单独发版本号,随合集仓库滚动更新(仓库最近提交 2026-10-01) |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill import-infrastructure-as-code,见第 9 章 |
2. 功能介绍与亮点
把已经存在于 Azure 订阅中的真实资源,逆向转换为可维护的 Terraform 代码,并优先采用 Azure Verified Modules(AVM,微软官方认证的 Terraform 模块库)而非手写 azurerm_* 资源。
- 支持三种发现范围:整个订阅、指定资源组、或一组具体资源 ID,用
az resource list/show完成发现,不依赖 Terraform provider 是否原生支持某资源类型的“列举”能力——因此能覆盖 AVM 索引内任意 Azure 资源类型 - 自动解析资源间的父子依赖关系(如网卡→子网→虚拟网络),生成
exported-resources.json与人类可读的架构说明文档 - 写代码前强制要求先读取目标 AVM 模块的 README,逐条核对必填/可选输入参数名与真实语义(如虚拟机模块里网卡、扩展是“模块内置管理”而非独立资源),避免凭记忆套用
azurerm原生参数名导致的生成错误 - 写
import {}导入块前强制先grep已下载的模块源码,确认 provider 类型(azurerm还是azapi)、嵌套子模块路径、count/for_each寻址方式,不允许凭记忆编写导入地址 - 内置“活属性 vs 模块默认值”差异比对步骤,专门捕捉超时时间、网络策略、SKU、可用区等容易被生成代码悄悄覆盖掉的真实配置,防止导入后出现配置漂移
- 明确要求把 Azure ARM 资源 ID 严格当作云资源标识符使用,禁止传给本地文件读取类命令——在说明文档层面写入了防注入设计
3. 适用场景
所属分类:DevOps 与基础设施。适合已经在 Azure 上手工或通过门户创建了一批资源、现在想把它们纳入 Terraform 统一管理的云工程师;也适合需要为既有 Azure 环境补做基础设施代码存档、防止后续配置漂移的团队。典型触发场景:资产盘点后决定上 IaC、团队交接缺少基础设施代码、或迁移至 AVM 标准模块体系。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 标准单文件 SKILL.md,可直接放入 .claude/skills/ |
| Codex | ⚠️ 需适配 | 不会自动发现 ~/.codex/skills,需手动引用路径 |
| OpenClaw | ✅ 原生支持 | 按目录扫描探测子目录 SKILL.md |
| Hermes Agent | ✅ 原生支持 | 同样按路径扫描探测 SKILL.md |
5. 推荐理由
把“把存量 Azure 资源补录成 Terraform 代码”这件容易出错的手工活,拆解成发现、依赖建模、AVM 模块核对、导入地址核验、配置漂移比对五个强制检查点,专门针对 AVM 生态里最常踩的坑给出具体应对方法,显著降低手写导入代码时的返工概率。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 第三方技能目录 skills.sh 收录并统计独立安装量约 7,000 次;合集仓库 stars 不计入本技能个体热度 |
| 可用性 | 8 | SKILL.md 内容详尽(含前置条件、分步工作流、故障排查表、响应契约),但依赖用户本机配置好 Azure CLI 登录与 Terraform CLI,并非零配置即用;仓库整体近日仍有提交,维护活跃 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单:① 执行的 shell 命令为 az/terraform 标准工具链的查询与生成类操作(resource list/show、init、plan、validate),不含自动 apply,范围明确可审计;② 仅联网读取 Terraform Registry 与 AVM 索引等公开文档,不外发用户数据;③ 依赖用户已有的 az login 会话,技能本身不存储或处理凭据;④ 全文无可疑指令,且明确要求“绝不把 ARM 资源 ID 当作文件路径传给读文件命令”,属主动的防注入设计;⑤ 作者为 GitHub 官方维护的社区合集仓库,信誉良好;⑥ License 明确(MIT);⑦ 仓库 2026-10-01 仍有提交,整体维护活跃。
7. 跟同类 Skills 相比的优势
| 候选 | 核心定位 | 覆盖方式 |
|---|---|---|
| import-infrastructure-as-code(本技能) | 把既有 Azure 资源逆向生成为 AVM 标准模块 Terraform 代码 | 用 Azure CLI 直接发现资源,覆盖 AVM 索引内任意资源类型;产出对齐微软官方认证模块 |
| terraform-search-import(hashicorp/agent-skills) | 用 Terraform 原生 terraform query 的 list 区块发现资源并批量生成导入配置 |
依赖 Terraform 1.14+ 且 provider 需支持“list resource”特性,目前对 AWS 覆盖较成熟,不针对 AVM 模块做适配 |
| azure-deployment-preflight(github/awesome-copilot) | 在新部署执行前校验 Bicep 语法与变更预览 | 面向尚未存在的新部署,不处理已存在资源的逆向建模 |
三者分工不同:本技能解决的是“已经存在的资源怎么补成规范代码”,terraform-search-import 是一条不依赖具体云厂商模块体系的通用发现-导入路径,azure-deployment-preflight 管的是全新部署前的校验。对于明确要用微软官方 AVM 模块体系、且 provider 尚不支持原生 list 发现的 Azure 资源类型,本技能提供了更具体的操作指引。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;skills.sh 技能目录收录了其独立安装量统计,但未见评价区内容。
9. 安装使用方式
- 一条命令安装(推荐):
npx skills add https://github.com/github/awesome-copilot --skill import-infrastructure-as-code - 手动安装:从 GitHub 仓库
skills/import-infrastructure-as-code/目录复制SKILL.md到所用 Agent 的 skills 目录(如 Claude Code 的.claude/skills/import-infrastructure-as-code/) - 安装后无需重启;触发方式是在对话中提及“把 Azure 资源导入 Terraform”“逆向生成 IaC”“盘点已有基础设施并建档”等意图;使用前需本机已安装并登录 Azure CLI(
az login),并已安装 Terraform CLI,且具备访问 Terraform Registry 与 AVM 索引源的网络连接
10. 注意事项
- 依赖本机已配置的
azCLI 登录会话与本机 Terraform CLI,首次使用需额外配置而非开箱即用 - 流程强制要求逐个核对 AVM 模块 README 与真实模块源码再写代码,耗时会随涉及资源种类增多而上升,不适合追求“一键完成”的场景
- 技能本身只生成代码并做
plan/validate校验,不会自动执行apply,仍需用户在确认生成结果无误后自行决定是否应用 - 并非所有 Azure 资源类型都已有对应 AVM 模块,遇到覆盖缺口时需要退回手写
azurerm_*资源并自行记录原因