원클릭으로
cdk-imp
AWS CDK実装専用コマンド。GitHub IssueからCDK実装・テスト・CDK合成まで自動実行する。CDKインフラの実装を依頼されたときに使用すること。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
메뉴
AWS CDK実装専用コマンド。GitHub IssueからCDK実装・テスト・CDK合成まで自動実行する。CDKインフラの実装を依頼されたときに使用すること。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
いま進行中のセッションの会話の流れを5項目で要約し、コンテキストスイッチから戻った人間が状況を思い出すのを助ける。「catchup」「ここまで要約して」「どこまでやったか」「文脈を思い出したい」と指示されたときに使う。
CDK実装の一気通貫オーケストレーションワークフロー。CDK実装→コードレビュー→レビュー指摘修正→CI実行→CI指摘修正を人間への確認なしに自律実行する。CLAUDE.md の開発フロー Step 7(CDK実装)で使用。Issue番号を引数に指定すること(例: /cdk-dev 15)。frontend/backend実装には使用しない。
アプリケーション実装の一気通貫オーケストレーションワークフロー。実装(テスト変更を含む場合はTDD、含まない場合は直接実装)→コードレビュー→レビュー指摘修正→CI実行→CI指摘修正→設計書整合性チェック→設計書修正を人間への確認なしに自律実行する。CLAUDE.md の開発フロー Step 6(frontend/backend実装)で使用。Issue番号を引数に指定すること(例: /code-dev 15)。CDKには使用しない。
統合設計ワークフロー。GitHub IssueをもとにIssueを読み込み設計書(docs/design/)を更新し、自動レビューと修正まで実行する。仕様駆動開発のStep 4で使用。Issue番号を引数に指定すること(例: /design 15)
AWS CDK インフラコードを詳細にレビュー。/cdk-review コマンドが呼ばれたとき、またはユーザーが CDK コードのレビューを依頼したときに使用する。cdk/ ディレクトリ内の TypeScript ファイルを対象に、型安全性・CDK ベストプラクティス・プロジェクトルール準拠を自動チェックする。
Plan ファイルを早期監査する(シフトレフト)。必須セクションの充足と、コードベース・ドキュメントへの影響範囲の網羅を Issue 化前にチェックする。「check-plan」「plan をチェック」と指示されたとき、または /to-plan から自動で呼ばれる。Plan の不足を指摘し、修正してから次工程へ進めるようにする。
| name | cdk-imp |
| description | AWS CDK実装専用コマンド。GitHub IssueからCDK実装・テスト・CDK合成まで自動実行する。CDKインフラの実装を依頼されたときに使用すること。 |
| argument-hint | <Issue番号> |
指定されたGitHub Issueを元に、設計書を参照してAWS CDKコード(cdk/ディレクトリ配下)のみを実装し、テスト・合成まで実行してください。
backend/やfrontend/配下のアプリケーションコードは絶対に実装・変更しないでください。
Issueのタスク一覧のうち、CDK/インフラに関するタスクのみを対象としてください。
完了したCDKタスクのみ gh issue edit コマンドでGitHub Issueのチェックリストを更新してください。
Issue指定:
引数が空の場合は、ユーザーにIssue番号を確認してください。
GitHub IssueからAWS CDK実装を実行する。 設計書を参照し、CDKルールを遵守したインフラコードを実装、テスト・合成まで実行する。
cdk/ディレクトリ配下)のみを対象とするbackend/、frontend/配下のアプリケーションコードは絶対に実装・変更しないことタスクプロンプトの「Issue指定:」の値を確認する。値が含まれている場合はそれを使用し、空の場合のみAskUserQuestionでユーザーに確認する。
question: "CDK実装を行うIssueを指定してください。Issue番号(例: 1)を入力してください。"
header: "Issue指定"
options: [
{ label: "その他(手動入力)", description: "Issue番号を入力してください" }
]
multiSelect: false
取得情報:
Bash ツールで GitHub Issue の情報を取得:
gh issue view {番号} --json number,title,body,labels
エラーハンドリング:
Issue が見つからない場合:
=== Issue 読み込みエラー ===
Error: Issue #{番号} が見つかりませんでした。
gh issue list で利用可能なIssue一覧を確認してください。
→ AskUserQuestion で再入力を促す(最大3回まで)
body が空の場合:
=== Issue 読み込みエラー ===
Error: Issue #{番号} の本文が空です。
→ 処理を中止
取得したJSONから以下の情報を抽出:
1. Issue番号とタイトル
.number フィールド.title フィールド2. ラベル
.labels[].name フィールドから抽出
[{name: "cdk"}, {name: "infra"}] → ['cdk', 'infra']3. スコープ/作業項目
body内 ## スコープ / 作業項目 セクションの内容全体を抽出
4. タスク一覧(CDKタスクのみ抽出)
body内 ## タスク一覧 セクションのチェックリスト(- [ ] 形式)を抽出し、CDK/インフラに関するタスクのみをフィルタリングする。
フィルタリングルール:
5. 対象ファイル
body内 ## 📂 コンテキスト または ### 対象ファイル セクションから抽出
cdk/lib/oidc-sandbox-stack.tscdk/lib/constructs/*.ts(新規Constructの場合)出力例:
=== Issue解析結果 ===
Issue: #1 CDK初期構築
ラベル: cdk, infra
対象ファイル: cdk/lib/oidc-sandbox-stack.ts
対象タスク(CDK/インフラ関連):
- [ ] CDKコード実装
- [ ] スナップショットテスト更新
- [ ] cdk synth確認
スキップするタスク(アプリケーションコード関連):
- [ ] Lambdaハンドラー実装 → 対象外
- [ ] フロントエンド実装 → 対象外
スコープ:
- CDKプロジェクト初期化
- スタック基本構成作成
抽出した情報をユーザーに提示し、開始確認:
question: "以下の内容でCDK実装を開始します。よろしいですか?"
header: "実装開始確認"
options: [
{ label: "はい、開始します", description: "CDK実装を開始します" },
{ label: "いいえ、中止します", description: "処理を中止します" }
]
Phase 1で抽出したラベル情報から、対象設計書を推測:
ラベルマッピングルール:
const labelToDesignDoc: Record<string, string[]> = {
cdk: ['docs/design/infrastructure-design.md'],
infra: ['docs/design/infrastructure-design.md'],
backend: ['docs/design/backend-design.md', 'docs/design/infrastructure-design.md'],
frontend: ['docs/design/frontend-design.md', 'docs/design/infrastructure-design.md']
}
推測ロジック:
infrastructure-design.md は常に参照対象結果例:
対象設計書:
- docs/design/infrastructure-design.md
- docs/design/backend-design.md(Lambda関数関連の場合)
Read ツールで以下のセクションを読み込み:
必須セクション:
file_path: docs/design/infrastructure-design.md
抽出する情報:
ラベルに応じて追加の設計書を読み込み:
Lambda関数追加の場合:
file_path: docs/design/backend-design.md
CloudFront/S3変更の場合:
file_path: docs/design/frontend-design.md
file_path: .claude/rules/cdk.md
確認事項:
import { aws_s3 as s3 } from 'aws-cdk-lib'設計書とCDKルールから抽出した情報を整理してユーザーに提示:
=== 実装方針サマリー ===
設計判断:
- Lambda Function URLs を使用(ADR-001)
- OAC + IAM認証(ADR-004)
CDKルール:
- L2 Construct優先
- Import形式: aws_s3 as s3
- IAM Role自動生成を活用
循環参照回避戦略:
- SSM Parameter Store の利用
- ワイルドカードリソース指定
- L1 Construct(Cfn)の活用
AskUserQuestion で実装方針を確認:
question: "上記の実装方針でCDKコードを実装します。よろしいですか?"
header: "実装方針確認"
options: [
{ label: "はい、この方針で実装します", description: "CDKコード実装に進みます" },
{ label: "いいえ、修正が必要です", description: "実装方針を見直します" }
]
Issue内の「📂 コンテキスト」または「### 対象ファイル」セクションから対象ファイルを取得:
cdk/lib/oidc-sandbox-stack.ts(メインスタック)Read ツールで対象ファイルを読み込み:
file_path: cdk/lib/oidc-sandbox-stack.ts
確認事項:
実装前に以下を確認:
Import形式:
// ✅ 正しい形式
import { aws_s3 as s3 } from 'aws-cdk-lib'
import { aws_lambda as lambda } from 'aws-cdk-lib'
// ❌ 避けるべき形式
import * as s3 from 'aws-cdk-lib/aws-s3'
Import順序:
// 1. 標準ライブラリ
import * as path from 'path'
// 2. サードパーティライブラリ(CDK含む)
import { Stack, StackProps, RemovalPolicy } from 'aws-cdk-lib'
import { aws_s3 as s3 } from 'aws-cdk-lib'
// 3. 自作モジュール
import { AppParameter } from '../parameter'
L2 Construct優先:
IAM Role自動生成:
Edit または Write ツールで実装:
実装ガイドライン:
コメント・JSDoc は docs/policy/code-comment-policy.md に従う(実装コメントは WHY、doc comment は契約。コードが語る WHAT/HOW は書かない)。
実装例:
/**
* S3バケットを作成
* @param {string} bucketName - バケット名
* @returns {s3.Bucket} - 作成されたS3バケット
*/
private createS3Bucket(bucketName: string): s3.Bucket {
// 1. S3バケット作成(L2 Construct使用)
const bucket = new s3.Bucket(this, 'FrontendBucket', {
bucketName: bucketName,
removalPolicy: RemovalPolicy.DESTROY,
autoDeleteObjects: true,
})
// 2. バケットポリシー設定(OAC用)
// 循環参照回避のため、CloudFront作成後にL1 Constructで設定
return bucket
}
実装したコードをユーザーに提示:
=== CDK実装完了 ===
実装ファイル: cdk/lib/oidc-sandbox-stack.ts
変更内容:
- Lambda Function作成(NodejsFunction使用)
- Lambda Function URL設定
- CloudFront Origin設定
- IAMポリシー自動生成
AskUserQuestion で確認:
question: "実装内容を確認してください。このままテストに進みますか?"
header: "実装確認"
options: [
{ label: "はい、テストに進みます", description: "npm testを実行します" },
{ label: "いいえ、修正が必要です", description: "実装を見直します" }
]
重要な考慮事項:
Bash ツールでCDKテストを実行:
cd cdk && npm test
成功判定: 終了コード 0
成功時:
✅ Tests Passed
All CDK tests passed successfully.
失敗時:
テストエラーメッセージを解析:
スナップショット不一致の検出:
その他のエラー:
スナップショット不一致が検出された場合:
⚠️ Snapshot Mismatch Detected
スナップショットテストが不一致です。以下のファイルで差分が検出されました:
cdk/test/__snapshots__/cdk.test.ts.snap
差分内容:
- CloudFormation テンプレートの変更
- リソース追加/削除
スナップショットを更新しますか?
AskUserQuestion でスナップショット更新の可否を確認:
question: "スナップショットを更新しますか?(実装内容が正しい場合は更新してください)"
header: "スナップショット更新"
options: [
{ label: "はい、更新します", description: "npm test -- -u を実行してスナップショットを更新" },
{ label: "いいえ、実装を修正します", description: "CDKコードを見直します" }
]
multiSelect: false
「はい」選択時:
cd cdk && npm test -- -u
スナップショット更新後、再度テスト実行:
cd cdk && npm test
「いいえ」選択時:
Phase 3に戻り、実装を修正
テスト失敗(スナップショット以外)の場合:
🔴 Test Failed
以下のエラーが検出されました:
cdk/lib/oidc-sandbox-stack.ts:42:7
Error: Property 'functionUrl' does not exist on type 'Function'.
原因:
Lambda Function URLはNodejsFunctionのプロパティとして直接アクセスできません。
修正方法:
1. FunctionUrl Constructを使用してURLを作成
2. または、addFunctionUrl() メソッドを使用
修正しますか?
AskUserQuestion で修正するか確認:
question: "上記のエラーを修正しますか?"
header: "エラー修正"
options: [
{ label: "はい、修正します", description: "エラーを修正してテストを再実行" },
{ label: "いいえ、中止します", description: "処理を中止します" }
]
「はい」選択時: Phase 3に戻り、実装を修正
エラーハンドリング:
Bash ツールでCloudFormationテンプレート合成:
cd cdk && npx cdk synth
成功判定: 終了コード 0
成功時:
✅ CDK Synth Passed
CloudFormation テンプレートが正常に生成されました:
cdk.out/oidc-sandbox-app.template.json
cdk.out/oidc-sandbox-app.assets.json
cdk.out/manifest.json
cdk.out/tree.json
失敗時:
合成エラーメッセージを解析:
循環参照エラーの検出:
その他のエラー:
循環参照エラーが検出された場合:
🔴 Circular Dependency Detected
循環参照エラーが検出されました:
Error: Circular dependency between resources:
- CloudFrontDistribution depends on LambdaFunctionUrl
- LambdaFunction depends on CloudFrontDistribution (via IAM policy)
原因:
CloudFrontのURLをLambda関数のIAMポリシーで参照しようとしています。
回避方法:
1. SSM Parameter Store を利用してCloudFront URLを保存
2. Lambda関数のIAMポリシーでワイルドカード指定('*')
3. L1 Construct(Cfn)を使用して後付け設定
AskUserQuestion で修正方法を確認:
question: "循環参照を回避するため、以下のいずれかの方法で修正します。どれを選択しますか?"
header: "循環参照回避"
options: [
{ label: "SSM Parameter Store を利用", description: "CloudFront URLをSSMに保存し、Lambda側で参照" },
{ label: "ワイルドカード指定", description: "IAMポリシーで '*' を使用" },
{ label: "L1 Construct 活用", description: "Cfn を使用して後付け設定" },
{ label: "手動で修正", description: "処理を中止して手動で修正" }
]
選択に応じて Phase 3 に戻り、実装を修正
合成エラー(循環参照以外)の場合:
🔴 Synth Failed
以下のエラーが検出されました:
Error: Bucket name must be lowercase
原因:
S3バケット名に大文字が含まれています。
修正方法:
bucketName を小文字に変更してください。
AskUserQuestion で修正するか確認:
question: "上記のエラーを修正しますか?"
header: "エラー修正"
options: [
{ label: "はい、修正します", description: "エラーを修正してcdk synthを再実行" },
{ label: "いいえ、中止します", description: "処理を中止します" }
]
「はい」選択時: Phase 3に戻り、実装を修正
循環参照の回避戦略(既存実装を参考):
'*')## CDK実装完了レポート
### 実装サマリー
Issue: #{番号} {タイトル}
実装ファイル:
- cdk/lib/oidc-sandbox-stack.ts
変更内容:
- Lambda Function URLの追加
- CloudFrontのOrigin設定更新
- IAMポリシーの自動生成
### テスト結果
| チェック項目 | 結果 |
| --- | --- |
| npm test | ✅ Passed (X tests) |
| cdk synth | ✅ Passed |
| 循環参照チェック | ✅ OK |
または失敗時:
### テスト結果
| チェック項目 | 結果 |
| --- | --- |
| npm test | 🔴 Failed |
| cdk synth | - |
| 循環参照チェック | - |
成功時:
### Next Steps
1. /cdk-ci で包括的な品質チェック(静的解析、型チェック)
2. cdk diff でデプロイ前の差分確認
3. cdk deploy で実際にデプロイ(人間が実施)
4. 結合テスト実行(人間が実施)
5. /git-commit でコミット作成
失敗時:
### Next Steps
1. 上記のエラーを修正
2. /cdk-imp を再実行
Bash ツールで実装・テスト・CDK合成に関するタスクを完了マークに更新:
BODY=$(gh issue view {番号} --json body --jq '.body')
# CDK実装・テスト・synth完了に関連するタスクを完了マークに更新
UPDATED_BODY=$(echo "$BODY" | sed 's/- \[ \] \(.*実装.*\)/- [x] \1/g' \
| sed 's/- \[ \] \(.*テスト.*\)/- [x] \1/g' \
| sed 's/- \[ \] \(.*synth.*\)/- [x] \1/g')
gh issue edit {番号} --body "$UPDATED_BODY"
該当するタスクが見つからない場合はスキップ(エラーにしない)。
出力フォーマット(完全版):
## CDK実装完了レポート
### 実装サマリー
Issue: #1 CDK初期構築
実装ファイル:
- cdk/lib/oidc-sandbox-stack.ts
変更内容:
- スタック基本構成作成
- S3バケット作成
- CloudFront設定
### テスト結果
| チェック項目 | 結果 |
| ---------------- | ------------------- |
| npm test | ✅ Passed (2 tests) |
| cdk synth | ✅ Passed |
| 循環参照チェック | ✅ OK |
### Next Steps
1. /cdk-ci で包括的な品質チェック(静的解析、型チェック)
2. cdk diff でデプロイ前の差分確認
3. cdk deploy で実際にデプロイ(人間が実施)
4. 結合テスト実行(人間が実施)
5. /git-commit でコミット作成
### GitHub Issue更新
✓ Issue #1 のタスクチェックリストを更新しました(gh issue edit で実装・テスト・synth完了を反映)
| エラー種別 | 判定方法 | 処理内容 |
|---|---|---|
| Issue が見つからない | gh issue view がエラー | エラーメッセージを表示し再入力を促す(最大3回) |
| Issue の body が空 | JSON body フィールドが空 | 処理を中止 |
| 設計書ファイルが見つからない | Read でエラー | 警告を表示し、Issueの情報のみで処理継続 |
| npm test 失敗 | 終了コード 非0 | エラーメッセージを解析し、修正方法を提案 |
| スナップショット不一致 | テストエラーメッセージに "snapshot" 含む | AskUserQuestion でスナップショット更新の可否を確認 |
| cdk synth 失敗 | 終了コード 非0 | エラーメッセージを解析し、修正方法を提案 |
| 循環参照エラー | エラーメッセージに "Circular dependency" 含む | 原因リソースを特定し、回避方法を提案(SSM/ワイルドカード/L1 Construct) |
| 修正試行回数超過 | 3回連続で同じエラー | 処理を中止し、ユーザーに手動修正を促す |
CLAUDE.md の指示により、TypeScriptコンパイル(tsc)は実行しない。
型エラーは npm test または cdk synth で検出される。
cdk deploy は実行しない。デプロイは人間が実施。
基本的に単一スタック構成(oidc-sandbox-stack.ts)を想定。
複数スタックの場合は設計書を確認。
CloudFormationの循環参照は以下のパターンで発生しやすい:
CloudFront ⇔ Lambda Function URL
Lambda ⇔ DynamoDB
S3 ⇔ CloudFront
以下の場合はスナップショット更新が必要:
ユーザーに確認後、npm test -- -u で更新。
同じエラーで3回連続失敗した場合は処理を中止。 無限ループを避け、ユーザーに手動修正を促す。