技能使用指南

writing-infrastructure-code（基础设施即代码）Skill 是什么？

基础设施即代码Skill 帮你在 Terraform、Pulumi、AWS CDK 之间做出正确选型，并给出远程状态与锁、可复用模块设计、漂移检测与 CI/CD 接入的完整方案。内含命令速查、检查清单与竞品对比，助你把手工云配置升级为可审查、可复现的代码化流程，立即了解如何一键安装使用。

基础设施即代码Skillwriting-infrastructure-code
8 个章节 约 15 分钟阅读 AI 智能生成

基础设施即代码Skill：把手工点控制台变成可审查、可复现的代码化云资源管理

  • 一句话定位：这是一个专注于「用代码管理云基础设施」的 AI 技能，覆盖 Terraform/OpenTofu、Pulumi、AWS CDK 三大主流 IaC 工具，从工具选型、状态管理到模块设计和部署工作流都给出可落地的方案。
  • 核心能力：工具选型决策、远程状态与锁机制设计、可复用模块设计、CI/CD 集成、漂移检测与故障排查。
  • 最适合谁：需要配置云资源（计算、网络、数据库、存储）的后端/运维/SRE 工程师，以及想把手工基础设施迁移到代码化工作流的团队。
  • 最大差别：不只是「给一段 Terraform 代码」，而是按团队构成与云策略给出工具取舍，并提示状态、安全、成本等容易踩坑的工程细节。
  • 使用门槛：你仍然需要理解云资源与 IaC 基本概念，但大量模板化、对比型、检查清单式的工作可以被显著加速。

1. 该技能叫什么？如何一键安装 AI 技能提升开发效率？

基本信息

项目 内容
技能中文名 基础设施即代码Skill
技能英文名 writing-infrastructure-code
技能ID 13375

它解决什么问题

在没有这类技能之前，工程师面对 IaC 任务通常是这样的：打开 Terraform 官方文档、翻 Pulumi 社区帖子、在通用 AI 对话里反复追问，得到的回答往往停留在「怎么写一个 resource 块」，而真正让人头痛的问题——状态文件该放哪、多人协作怎么加锁、模块怎么拆、生产环境怎么防止误操作——很难一次性问清楚。这个技能把 IaC 领域的工具选型框架、状态管理策略、模块设计原则、检查清单与故障排查方法沉淀成一份结构化的知识包，让 AI 助手在回答基础设施问题时具备「工程视角」，而不是只给语法示例。

一键安装思路与步骤

「一键安装」的核心逻辑是：把技能包挂载到支持技能机制的 AI 助手中，之后在同一对话里提出 IaC 相关问题，助手会自动按技能的规范作答。具体操作如下：

  1. 确认前提：你的 AI 编程助手/客户端需要支持「技能（Skill）」扩展机制。不同客户端的支持情况与目录规范不同，请以官方说明为准。
  2. 获取技能包：通过官方技能市场、技能仓库或团队内部技能分发渠道获取该技能（技能ID：13375）。安装入口的具体位置与命令以官方说明为准。
  3. 完成安装：按官方文档把技能放入技能目录或通过市场「安装/启用」按钮完成绑定，通常无需额外配置依赖。
  4. 验证是否生效：新建一个对话，提一个典型问题，例如「我们团队 5 个人，用 AWS，想从手工建资源迁移到 IaC，选 Terraform 还是 CDK？状态怎么管？」如果回答中出现了工具选型决策逻辑、远程状态与锁的建议、以及模块拆分思路，说明技能已正常加载。若回答仍是泛泛而谈，请检查技能是否被正确启用，以官方说明为准。
  5. 进阶用法：把技能与 CI/CD 相关技能组合使用，可以让 AI 同时产出「基础设施代码」和「流水线配置」两部分内容（技能文档中提及了与 building-ci-pipelines、gitops-workflows 等技能的集成关系）。

2. 该技能的主要功能和特点

  • IaC 工具选型框架：内置决策树，按「是否需要多云 → 团队是运维为主还是开发者为主 → 是否仅限 AWS → 语言偏好」逐层收敛，最终给出 Terraform/OpenTofu、Pulumi、AWS CDK 或 CloudFormation 的建议，并解释每个选择背后的权衡（提供商生态、编程语言、抽象层级）。
  • 状态管理架构设计：覆盖后端选型（AWS 用 S3 + DynamoDB、GCP 用云存储、Azure 用 Blob 租约、多云用 Terraform Cloud、Pulumi 用 Pulumi 服务）、锁机制、状态隔离的三种策略（目录分离、工作空间、分层架构）及各自风险。
  • 模块设计与版本化：给出可组合模块的目录结构范式（vpc / 安全组 / rds / ecs集群 / ecs服务 / alb），并明确「什么时候该抽模块、什么时候保持单一」的判断标准，避免过度抽象。
  • 工作流与操作规范：从功能分支编写、本地 plan/preview、带计划输出的 PR、代码审查关注点（安全、成本、爆炸半径）到批准后应用、部署后监控漂移，形成完整闭环。
  • 三大工具的常用命令速查：Terraform（init/plan/apply/destroy/fmt/validate/state/import/workspace）、Pulumi（new/preview/up/destroy/stack/import/export）、AWS CDK（init/synth/diff/deploy/bootstrap/list），无需反复查文档。
  • 检查清单能力：分别针对基础设施配置、模块开发、操作准备给出勾选式清单，适合直接用于 PR 评审或上线前自查。
  • 故障排查指导：状态锁冲突（terraform force-unlock）、存量资源导入（terraform import / pulumi import）、漂移检测（terraform plan -detailed-exitcode 退出码 2 表示检测到漂移）、状态恢复等高频事故场景都有对应思路。
  • 配套参考与示例索引：技能包含 references 目录（Terraform 模式、Pulumi 模式、状态管理、模块设计、漂移检测）与 examples 目录（VPC 模块、ECS 服务、Aurora 集群、状态后端等），以及 validate/cost-estimate/drift-check/security-scan/state-backup/module-release 等实用脚本。

和普通工具比强在哪：普通搜索或通用 AI 往往只能给单点代码片段；这个技能给的是「决策 + 结构 + 清单 + 排错」的完整工程链路，并且默认把安全（密钥不入库、敏感输出标记）、成本（应用前估算、标签分配）、协作（远程状态 + 锁）这些容易被忽略的约束前置。

3. 如何使用该技能？

以下为典型使用流程，全部在自然语言对话中完成：

  1. 明确场景与约束。先说清楚云厂商、团队规模、技术栈、是否多云。示例输入：「我们是 6 人后端团队，只用 AWS，成员都会 TypeScript，现在资源都是控制台手工建的，想迁到 IaC，请给出工具选型和一个分阶段迁移路线。」
  2. 获取选型结论与理由。技能会按决策树给出建议（例如仅 AWS + TypeScript 倾向 AWS CDK，或声明式偏好选 Terraform），并说明后续状态管理方式。
  3. 让技能产出骨架工程。示例输入：「按你建议的方案，给我一个多可用区 VPC 的模块骨架，包含公有/私有子网、变量定义、输出定义和 examples 目录说明。」
  4. 补齐状态与协作配置。示例输入：「为团队协作设置带锁的远程状态，后端用 S3 + DynamoDB，给出配置片段和注意事项。」输出会包含后端配置、加密与版本化、以及「状态文件绝不提交到 Git」这类硬性规则。
  5. 本地验证。按输出提示在本地执行 terraform init、terraform fmt、terraform validate，再执行 terraform plan 预览变更；Pulumi 项目则用 pulumi preview，CDK 项目用 cdk synth 与 cdk diff。
  6. 接入流水线。示例输入：「把 terraform plan/apply 接进 CI，PR 阶段只 plan、合并主干后 apply，需要哪些步骤和安全约束？」
  7. 上线后治理。示例输入：「为现有基础设施实现漂移检测，并给出定期执行的方案。」技能会给出基于 plan -detailed-exitcode 或 pulumi preview --diff 的检测思路与调度建议。
  8. 输出说明：技能的产出通常是「结论 + 代码片段 + 检查清单 + 风险提示」的组合，你应当把代码片段落到仓库、把清单用于 PR 评审，而不是直接复制到生产环境执行。任何涉及真实云账号的操作，请先在非生产环境验证。

4. 同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
基础设施即代码Skill（本技能） 面向 IaC 全流程的 AI 技能知识包 工具选型决策树、状态管理架构、模块设计、命令速查、检查清单、漂移排查 需支持技能机制的 AI 客户端，安装入口以官方说明为准；使用者需具备基础云知识 从零搭建 IaC、工具选型评估、模块化改造、流水线接入 优势：跨 Terraform/Pulumi/CDK 统一给建议，强调工程约束与排错；不足：不替代真实执行环境，最终代码仍需人工评审与实测
Terraform/OpenTofu 官方文档 + CLI 声明式 IaC 工具本体 HCL 语法、3000+ 提供商、模块注册表、状态与锁、plan/apply 需自行安装 CLI 与配置后端；文档量大，需自行筛选 多云/混合云、运维与 SRE 主导的团队 优势：生态最成熟、社区资料最多；不足：HCL 需要专门学习，复杂逻辑表达不便，选型与最佳实践需自行判断
Pulumi 官方文档 + CLI 以编程语言为中心的 IaC TypeScript/Python/Go 编写、原生测试框架、强类型与 IDE 补全 需安装 CLI 与语言工具链；对开发者友好 开发者主导、逻辑复杂、需要单元测试的基础设施 优势：可复用编程构造与测试体系；不足：声明式直观性弱于 HCL，团队需具备工程化编码能力
AWS CDK 官方文档 + CLI AWS 原生 IaC，底层走 CloudFormation L1/L2/L3 构造、语言化定义、synth/diff/deploy 需安装 CDK CLI 并 bootstrap 账户区域 纯 AWS 环境、与 AWS 服务深度集成 优势：抽象层级高、AWS 集成紧；不足：锁定 AWS，脱离 AWS 后不可用，CloudFormation 层问题排查成本较高

5. 该技能的典型应用场景与实际体验情况

场景一：初创团队从零建立 IaC 规范

角色是 3~5 人的后端团队，痛点是从控制台手工建资源，配置散落在个人记忆里，环境无法复现。使用方式是让技能先做选型，再产出 VPC、数据库、容器服务的最小模块集合，并同步给出「从第一天起就用远程状态」的规范。实际体验：决策路径清晰，几乎不需要额外查资料；需要注意的是团队要真正执行清单里的事项（如敏感输出标记、标签策略），否则规范只是文档。

场景二：中小团队的多人协作状态治理

痛点是两个人同时 apply 导致状态冲突，或状态文件被误提交到仓库。使用方式是以「为团队协作设置带锁的远程状态」为起点提问，技能会给出后端选型对照表、隔离策略建议（多数团队推荐目录分离）与状态锁规则。实际体验：状态隔离策略的三种方案对比非常有价值，能帮团队避开「用工作空间管理多环境导致误操作」的常见坑；迁移存量状态仍需谨慎，建议先在测试环境演练。

场景三：存量资源迁移与漂移治理

痛点是一大批资源是手工创建的，直接纳管困难，且有人绕过 IaC 直接改配置。使用方式分两步：先用 terraform import / pulumi import 处理存量资源纳管，再用漂移检测机制定期比对。实际体验：技能给出的 plan -detailed-exitcode（退出码 2 表示有漂移）这类细节非常实用，可直接落到定时任务里；注意事项是导入前要确认资源 ID 与命名，避免状态错乱。

场景四：IaC 代码评审与上线前自查

角色是技术负责人或 reviewer，痛点是 PR 里只有一堆资源定义，看不出安全与成本风险。使用方式是让技能按「基础设施配置 / 模块开发 / 操作准备」三张清单逐项检查，并结合安全扫描（Checkov/tfsec）与成本估算（Infracost）的集成建议。实际体验：上手难度低，把清单直接贴进 PR 模板即可见效；长期价值在于把评审关注点从「语法对不对」转向「爆炸半径与成本影响」。

6. 该技能能为用户带来的价值

  • 缩短选型与方案设计时间：工具选型、状态架构、模块边界这三件事通常要花掉工程师数小时到数天的调研与讨论，技能把它们压缩成一次结构化对话。
  • 降低 IaC 的入门门槛：对只熟悉控制台操作的工程师，技能提供了从命令速查到检查清单的完整脚手架，不必先啃完全部官方文档。
  • 减少生产事故概率：远程状态、锁、加密、敏感输出标记、漂移检测等关键约束被前置到方案中，能从源头减少「状态冲突」「密钥入库」「手工改动被覆盖」类事故。
  • 提升协作与可审计性：基础设施变更走 Git 与代码评审，变更历史可追溯，灾难恢复时可以从代码重建环境。
  • 可控的成本与合规：通过标签策略、应用前成本估算、安全扫描集成，让成本与安全成为流程的一部分，而不是事后补救。
  • 长期价值：技能沉淀的是一套可复用的工程方法论，团队一旦按此建立模块库与工作流，后续新项目复用的边际成本会持续下降。

7. 常见问题 FAQ

Q1：这个技能怎么安装？需要什么前提？ A：需要你的 AI 助手支持技能（Skill）扩展机制，然后通过官方技能市场或技能仓库安装（技能ID：13375）。具体安装入口、目录规范与命令以官方说明为准。安装后用一个具体的 IaC 选型问题测试回答是否包含决策逻辑与状态管理建议，即可判断是否生效。

Q2：使用这个技能收费吗？ A：技能本身是否收费、是否需要配合付费的 AI 客户端使用，取决于官方发行渠道与你的客户端订阅方案，以官方说明为准。技能产出的代码不会产生额外费用，但你实际部署的云资源仍按云厂商计费。

Q3：它适合谁用？不懂 IaC 的新手能直接用吗？ A：最适合需要配置云资源的后端、运维与 SRE 工程师，以及正在推进基础设施代码化的团队负责人。新手可以用它快速建立正确的工程习惯（远程状态、模块边界、检查清单），但它不替代对云资源本身的理解，建议先在非生产环境实践。

Q4：它和直接看 Terraform 官方文档、或用通用 AI 助手有什么区别？ A：官方文档是工具说明书，通用 AI 助手偏向给代码片段；这个技能的价值在于「跨工具的决策与工程约束」，比如同时比较 Terraform、Pulumi、AWS CDK 的适用边界，并主动提示状态锁、漂移检测、成本与安全扫描这些容易漏掉的环节。三者可以配合使用：技能定方向，官方文档查细节。

Q5：技能会不会直接改动我的云环境？安全吗？ A：技能输出的是方案、代码片段与操作建议，实际执行仍由你在本地或 CI 中完成，因此不会自行改动云环境。安全实践上应遵循技能强调的原则：密钥不入库、敏感输出标记为敏感、应用前做安全扫描与成本估算、状态文件静态加密并定期备份。