메뉴
cdk diffを実行し、変更内容をMarkdownテーブルで整形して表示する。インフラ変更のレビューやデプロイ前確認に使用する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | cdk-diff |
| description | cdk diffを実行し、変更内容をMarkdownテーブルで整形して表示する。インフラ変更のレビューやデプロイ前確認に使用する。 |
| context | fork |
| agent | general-purpose |
以下の手順を実行する：
cdk/ ディレクトリで以下のコマンドを実行する：
cd cdk && npx cdk diff 2>&1
出力を解析して、下記フォーマットに従ってMarkdownを生成して出力する。
スタックごとの変更件数を表形式で示す。
## CDK Diff 結果
### 📊 変更サマリー
| スタック | ➕ 追加 | 🔄 更新 | ➖ 削除 |
|---------|:------:|:------:|:------:|
| MyStack | 2 | 1 | 0 |
変更がない場合は 変更はありません ✅ と表示して終了する。
変更種別ごとに独立したセクションを設ける。各セクションは変更がある場合のみ出力する。
### ➕ 追加されるリソース
| スタック | リソースタイプ | 論理ID |
|---------|------------|------|
| MyStack | AWS::Lambda::Function | MyFunction |
更新の場合は変更前・変更後を独立した列で示す。プロパティが複数ある場合は行を分ける。
### 🔄 更新されるリソース
| スタック | 論理ID | プロパティ | 変更前 | 変更後 |
|---------|------|---------|:----:|:----:|
| MyStack | MyFunction | Runtime | nodejs16.x | nodejs20.x |
| MyStack | MyBucket | VersioningConfiguration | Suspended | Enabled |
### ➖ 削除されるリソース
| スタック | リソースタイプ | 論理ID |
|---------|------------|------|
| MyStack | AWS::IAM::Role | OldRole |
AWS::IAM::* に対する変更がある場合のみ、最後に注記セクションを追加する。
### ⚠️ IAMの変更
以下のIAMリソースに変更があります。意図した変更か確認してください。
| スタック | 変更種別 | リソースタイプ | 論理ID |
|---------|---------|------------|------|
| MyStack | 🔄 更新 | AWS::IAM::Role | MyRole |
cdk diff 出力の記号と意味：
| 記号 | 意味 |
|---|---|
[+] | 追加 |
[-] | 削除 |
[~] | 更新 |
└─ [~] PropertyName: "old" => "new" の形式で入れ子になっている。更新テーブルの「変更前」「変更後」列にそれぞれの値を記載する。AWS::CDK::Metadata の変更は無視する。AWS CDK インフラコードを詳細にレビュー。/cdk-review コマンドが呼ばれたとき、またはユーザーが CDK コードのレビューを依頼したときに使用する。cdk/ ディレクトリ内の TypeScript ファイルを対象に、型安全性・CDK ベストプラクティス・プロジェクトルール準拠を自動チェックする。
CDKインフラコードの静的解析・スナップショットテスト・cdk synthを実行する。インフラコードのCDK CIチェックを依頼されたときに使用すること。
backendとfrontendの静的解析・単体テストを実行する（CIパイプラインシミュレーション）。CIチェックやコミット・PR前のコード品質検証を依頼されたときに使用すること。
TypeScript アプリケーションコードをレビュー。/code-review コマンドが呼ばれたとき、またはユーザーが TypeScript/React コードのレビューを依頼したときに使用する。型安全性・設計原則・セキュリティ・プロジェクトルール準拠を自動チェックする。
設計書（docs/design/）とアプリケーションコード（backend/、frontend/）の整合性を検証する。 「/validate-design」「設計書と実装の整合性チェック」と指示されたときに使用する。
CDK実装の一気通貫オーケストレーションワークフロー。CDK実装→コードレビュー→レビュー指摘修正→CI実行→CI指摘修正を人間への確認なしに自律実行する。CLAUDE.md の開発フロー Step 7（CDK実装）で使用。Issue番号を引数に指定すること（例: /cdk-dev 15）。frontend/backend実装には使用しない。