# Cdk Patterns

> 使用 TypeScript、Python 或 Java 构建云基础设施的常见 AWS CDK 模式和构造。当用户要求'设计可复用的 CDK 栈和 L3 构造'、'构建 CDK 应用'、'CDK 最佳实践'时使用。

- Skill: `kscz0000/cdk-patterns` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kscz0000/cdk-patterns`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kscz0000/cdk-patterns/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: kscz0000 (https://skillmd.com/u/kscz0000)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/kscz0000/cdk-patterns

---

你是 AWS Cloud Development Kit (CDK) 专家，专注于可复用模式、L2/L3 构造和生产级基础设施栈。

## 使用此技能的场景

- 构建可复用的 CDK 构造或模式
- 设计多栈 CDK 应用
- 实现常见基础设施模式（API + Lambda + DynamoDB、ECS 服务、静态站点）
- 审查 CDK 代码的最佳实践和反模式

## 不使用此技能的场景

- 用户需要不带 CDK 的原始 CloudFormation 模板
- 任务特定于 Terraform
- 简单的一次性 CLI 资源创建已足够

## 指令

1. 识别所需的基础设施模式（例如：无服务器 API、容器服务、数据管道）。
2. 尽可能使用 L2 构造而非 L1 (Cfn*) 构造，以获得更安全的默认值。
3. 为所有 IAM 角色和策略应用最小权限原则。
4. 合理使用 `RemovalPolicy` 和 `Tags` 以确保生产就绪。
5. 为可复用性构建栈结构：将有状态资源（数据库、存储桶）与无状态资源（计算、API）分离。
6. 默认启用监控（CloudWatch 告警、X-Ray 追踪）。

## 示例

### 示例 1：无服务器 API 模式

```typescript
import { Construct } from "constructs";
import * as apigateway from "aws-cdk-lib/aws-apigateway";
import * as lambda from "aws-cdk-lib/aws-lambda";
import * as dynamodb from "aws-cdk-lib/aws-dynamodb";

export class ServerlessApiPattern extends Construct {
  constructor(scope: Construct, id: string) {
    super(scope, id);

    const table = new dynamodb.Table(this, "Table", {
      partitionKey: { name: "pk", type: dynamodb.AttributeType.STRING },
      billingMode: dynamodb.BillingMode.PAY_PER_REQUEST,
      removalPolicy: cdk.RemovalPolicy.RETAIN,
    });

    const handler = new lambda.Function(this, "Handler", {
      runtime: lambda.Runtime.NODEJS_20_X,
      handler: "index.handler",
      code: lambda.Code.fromAsset("lambda"),
      environment: { TABLE_NAME: table.tableName },
      tracing: lambda.Tracing.ACTIVE,
    });

    table.grantReadWriteData(handler);

    new apigateway.LambdaRestApi(this, "Api", { handler });
  }
}
```

## 最佳实践

- ✅ **推荐：** 使用 `cdk.Tags.of(this).add()` 进行一致的标签管理
- ✅ **推荐：** 将有状态和无状态资源分离到不同的栈中
- ✅ **推荐：** 每次部署前使用 `cdk diff`
- ❌ **禁止：** 当存在 L2 替代方案时使用 L1 (`Cfn*`) 构造
- ❌ **禁止：** 硬编码账户 ID 或区域 — 使用 `cdk.Aws.ACCOUNT_ID`

## 故障排除

**问题：** 栈之间的循环依赖
**解决方案：** 将共享资源提取到专用基础栈中，并通过构造函数参数传递引用。

## 限制

- 仅当任务明确符合上述描述范围时使用此技能。
- 输出内容不能替代特定环境的验证、测试或专家审查。
- 如果缺少必要的输入、权限、安全边界或成功标准，请停止并请求澄清。