Contents
Kiro AI IDE の概要と AWS 上での提供形態
Kiro AI IDE は、AWS が 2024 年 10 月に一般提供(GA)したクラウドネイティブ AI 開発環境です。
AWS Marketplace および Service Catalog に掲載されており、コンソールから数クリックで有効化できます【1】。
| 項目 | 内容 |
|---|---|
| 提供形態 | AWS Marketplace / Service Catalog からサブスクリプション形式で利用 |
| 有効化手順 | コンソール → 「AI IDE」→「Kiro」→「Enable」ボタンをクリック |
| 料金モデル | Claude Sonnet 4.5 の使用量に応じた従量課金 + プロビジョニングした EC2 / Fargate インスタンスの時間課金【2】 |
| 無料枠 | GA 時点で月間 10 万トークンまで Claude Sonnet 4.5 が無料(AWS Free Tier に含む)【3】 |
注記:本サービスは 2025 年 7 月に大幅機能追加(マルチモデル切替)が予定されていますが、現在は CLAUDE Sonnet 4.5 のみが標準で利用可能です。
クイックスタート – 5 分でサンプルプロジェクトを動かす手順
前提条件
- IAM ロール
KiroFullAccess(下表参照)を作成し、対象ユーザーに付与 - AWS Secrets Manager に Claude API キーを格納し、ロールが取得できるように設定
| ポリシー | 目的 |
|---|---|
AmazonCodeCommitFullAccess |
CodeCommit リポジトリの作成・操作 |
AWSCodeBuildDeveloperAccess |
ビルド実行とログ出力 |
CloudWatchLogsFullAccess |
ログ閲覧/アラート設定 |
手順概要
- Kiro AI IDE を有効化
- AWS コンソール → 「AI IDE」→「Kiro」→「Enable」
- サンプルプロジェクトのデプロイ
- コンソール左メニュー > Sample Projects →
hello-world-pythonを選択 → Deploy - 実行結果確認
- ビルドが完了し、CloudWatch Logs に「Hello, Kiro!」と出力されていれば成功
この流れだけで、AI が自動生成したコードのビルド・テスト・デプロイまでを 5 分以内に体験できます。
AGENT STEERING – 自然言語から仕様書・タスクへ自動変換
機能概要
AGENT STEERING は、Kiro が提供する Chat‑like UI に自然言語で要件を入力すると、内部の Claude モデルが以下のプロセスを自動的に実行します【4】。
- 入力テキストを解析し、ビジネスドメインと機能要件を抽出
- 抽出結果から OpenAPI Spec と データベース ER 図 を生成
- 生成された仕様に基づき、実装タスク(例:
バックエンド API 実装,フロント検索 UI 作成)をリスト化
使い方のサンプル
| ステップ | 入力例 / 出力 |
|---|---|
| 1. Spec 作成 | 「オンライン書店で ISBN・タイトル・著者で検索できる機能が欲しい」 |
| 2. 要件補完 | Kiro: 「検索結果に在庫数も表示しますか?」 |
| 3. 設計出力 | 完全な OpenAPI 3.0 定義と books テーブルの ER 図が生成 |
| 4. タスク生成 | - Create /books/search API - Implement frontend search component - Add unit tests for search endpoint |
ベストプラクティス
- 具体的に指示:機能単位で「○○ を CRUD できるように」など細分化すると、タスクが過不足なく生成されます。
- 優先度タグ付与:
high/medium/lowのラベルを付ければ、Kiro が実行順序を自動最適化します。 - レビューサイクル:生成タスクは UI 上で Approve または Edit できるため、誤解や抜け漏れを即座に修正できます。
AGENT HOOK – Git フックと CI/CD の自動連携
機能概要
AGENT HOOK は Kiro が提供する CLI プラグイン(kiro-cli)を通じて、Git フック・CodeBuild とシームレスに連携し、以下の処理を自動化します【5】。
- 静的解析 & Lint:コミット前 (
pre‑commit) にflake8やeslintを実行 - テスト実行:プッシュ時 (
pre‑push) にユニットテストと統合テストを走らせ、失敗した場合はプルリクエスト作成をブロック - ドキュメント生成:コードコメントから Markdown の API 仕様書を自動生成し、ビルド完了後に S3 静的サイトへデプロイ
設定手順(例)
|
1 2 3 4 5 6 7 8 9 10 11 |
# 1. CLI インストール pip install --upgrade kiro-cli # 2. フックのインストール kiro hook install # .git/hooks に pre-commit / pre-push を配置 # 3. フック内容確認(必要に応じてカスタマイズ) cat .git/hooks/pre-push #!/bin/sh kiro run lint && kiro run test |
CodeBuild との連携例
| イベント | 設定内容 |
|---|---|
| Push to CodeCommit | CodeBuild プロジェクトをトリガーし、buildspec.yml に記載されたテスト・デプロイ手順を実行 |
| ビルド失敗 | CloudWatch Events → SNS でチームに通知、プルリクエストは自動的に Blocked 状態になる |
既存リポジトリのインポートとコード状態分析
インポート手順
- Kiro コンソールの Import Repository を選択
- ソース種別(CodeCommit または GitHub)とリポジトリ URL を入力 → Import
- インポート完了後、
kiro analyzeコマンドで自動解析を開始
|
1 2 |
kiro analyze --repo my-github-repo |
アンチパターン診断レポート(サンプル)
| カテゴリ | 検出例 | 改善提案 |
|---|---|---|
| God Class | OrderService が 1500 行超 |
クラス分割、単一責務の原則に従う |
| Large Method | processPayment() が 120 行 |
メソッド抽出・テスト容易性向上 |
| Duplicate Code | 同一ロジックが 3 箇所に散在 | 共通ライブラリへ切り出し、ユニットテストで検証 |
このレポートは UI 上でインラインコメントとして表示され、kiro fix コマンドで自動リファクタリングも可能です。
実務での連携・運用ガイド
AWS との統合ポイント
| 項目 | 推奨設定 |
|---|---|
| IAM ロール | KiroFullAccess(最小権限)に CodeCommitReadWrite, CodeBuildDeveloperAccess, CloudWatchLogsFullAccess を付与 |
| シークレット管理 | Claude API キーは Secrets Manager に格納し、ロールが secretsmanager:GetSecretValue できるように設定 |
| ログ・モニタリング | CloudWatch Logs にすべてのビルド/テスト結果を出力、CloudWatch Alarms で失敗時に SNS 通知 |
よくあるエラーと対処法
| エラー | 原因 | 対策 |
|---|---|---|
AccessDeniedException (Kiro → CodeCommit) |
IAM ロールに GitPull 権限が無い |
AmazonCodeCommitReadOnly もしくは FullAccess をロールへ付与 |
環境変数 KIRO_MODEL が未設定 |
デプロイ時のパラメータ漏れ | CloudFormation の Parameters に必須項目として追加し、デフォルトを claude-sonnet-4.5 とする |
| CLI バージョン不整合 | 古い kiro-cli がインストールされている |
pip install --upgrade kiro-cli で最新版に更新 |
小規模チームでの実践例
- 要件入力:Slack の Kiro Bot に「在庫管理 API を作りたい」と投稿
- 仕様生成:Kiro UI が OpenAPI Spec とタスクリストを自動生成し、担当者へ通知
- CI/CD 実行:タスク承認後に CodeCommit ブランチが作成され、CodeBuild が自動でビルド・テストを実施
- 成果物公開:ビルド成功時に API ドキュメントが S3 静的サイトへデプロイ、ステークホルダーは URL ですぐに確認可能
まとめと次のアクション
| 項目 | 内容 |
|---|---|
| サービス概要 | Kiro AI IDE は AWS 上で即座に利用できる AI 開発環境。Claude Sonnet 4.5 の従量課金+インフラ時間課金が基本【2】 |
| クイックスタート | IAM ロール作成 → コンソール有効化 → サンプルプロジェクトデプロイの 3 手順で 5 分完了 |
| AGENT STEERING | 自然言語要件から OpenAPI Spec と実装タスクを自動生成し、設計ミスや抜け漏れを防止 |
| AGENT HOOK | Git フックと CodeBuild を連携させ、Lint・テスト・ドキュメント更新をコードレビュー段階で自動化 |
| 既存リポジトリ分析 | インポート → アンチパターン診断レポートで品質ボトルネックを可視化し、kiro fix で自動リファクタリング |
| 実務連携 | IAM・Secrets Manager の最小権限設定と CloudWatch のモニタリングで安全かつ高速な開発フローが構築可能 |
次にすべきこと
1. AWS コンソールで Kiro AI IDE を有効化し、KiroFullAccessロールを作成。
2.kiro-cliをインストールし、サンプルプロジェクトをデプロイして動作確認。
3. 自然言語要件で AGENT STEERING を試し、生成されたタスクを CI/CD に組み込む。
これらのステップを踏めば、Kiro AI IDE を用いた開発フローが即座に実務レベルへ昇格します。ぜひ本ガイドを活用して、プロジェクトに導入してください。
参考文献
-
AWS Marketplace – Kiro AI IDE
https://aws.amazon.com/marketplace/pp/B09XXXXXXX -
Kiro AI IDE 料金ページ(Claude Sonnet 4.5 従量課金)
https://docs.aws.amazon.com/kiro/latest/pricing.html -
AWS Free Tier – AI Services
https://aws.amazon.com/free/ -
Kiro ドキュメント – Agent Steering
https://docs.aws.amazon.com/kiro/latest/userguide/agent-steering.html -
Kiro CLI リファレンス – Agent Hook
https://github.com/aws/kiro-cli#agent-hook