Kiro AI IDE 導入ガイド：AWS SSO 連携・日本語化・仕様駆動開発

1. 前提条件と環境準備

Kiro は AWS の認可情報（IAM ロール）を直接参照してリソースへアクセスします。そのため シングルサインオン (SSO) が有効な IAM Identity Center と、Kiro 用に最小権限だけを付与したロールが必須です。このセクションでは AWS アカウント作成から SSO 連携、ロール・ポリシーの具体的設定までを順に紹介します。

1.1 AWS アカウント作成と IAM Identity Center の有効化

ポイント
- IAM Identity Center を有効にしないと SSO が機能せず、Kiro のサインインで毎回個別認証が走ります。
- ユーザーは必ず KiroDevelopers グループに所属させ、ロールマッピングの対象にしてください。

1.2 Kiro 用ロールの作成と最小権限ポリシー

Kiro が必要とする権限は以下の通りです（公式ドキュメント参照）。AdministratorAccess を付与すると過剰な権限が付くため、以下のカスタムポリシーで 最小権限 を実現します。

1.2.1 カスタムポリシー例（JSON）

注記
- kiro:* は実際のサービス名に合わせて置き換えてください（例：codeguru-reviewer:* など）。
- 上記ポリシーは リソース制限なし としていますが、プロジェクトごとに ARN を絞ることでさらに安全になります。

1.2.2 ロール作成手順（コンソール）

ポイント
- ポリシーは必ず カスタム とし、AdministratorAccess は使用しないこと。過剰権限はセキュリティ上のリスクとなります。

2. Kiro AI IDE のインストール

Kiro は Web コンソール、デスクトップクライアント、VS Code 拡張 の三形態で提供されています。本章ではそれぞれを取得する手順と、インストール後に必ず行う SSO 認証設定を解説します。

2.1 Web コンソールとデスクトップ版の取得

ポイント
- Web とデスクトップは同一バックエンド API を共有しているため、どちらでも同じ設定が反映されます。

2.2 VS Code 拡張機能のインストール

ポイント
- 拡張は「AWS SSO」認証だけで利用可能です。別途 IAM ロールの設定は不要ですが、ロールに付与した最小権限ポリシーが有効かどうかはコンソールで確認してください。

3. Visual Studio Code の日本語化と基本設定

3.1 Japanese Language Pack の導入

Kiro 自体は言語依存しませんが、エディタ全体が日本語表示になることで操作ミスが減ります。以下の手順で Japanese Language Pack for VS Code をインストールします。

1. 拡張機能パネルで検索 → Japanese Language Pack（出版社: Microsoft）を見つけて 「Install」。
2. 再起動 → インストール後に表示されるポップアップから 「Reload」 を選択、または VS Code を手動で再起動。
3. ロケール設定の確認 → File → Preferences → Settings → 検索ボックスに locale と入力し、"ja" が設定されていることをチェック。必要なら settings.json に以下を追記：

json
{
"workbench.locale": "ja"
}

3.2 Format On Save の有効化とフォーマッタ選定

Kiro が生成したコードは一貫したスタイルで保存したいものです。保存時自動整形 を有効にし、チームが利用しているフォーマッタ（例：Prettier）をデフォルトに設定します。

1. コマンドパレットから設定ファイルを開く → Ctrl+Shift+P → Preferences: Open Settings (JSON)。
2. 以下の項目を追記または上書き：

json
{
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode",
// Prettier の設定例（必要に応じて調整）
"prettier.singleQuote": true,
"prettier.trailingComma": "all"
}

1. 保存 → 設定が反映されると、以降ファイル保存時に自動で Prettier が走り、インデントや改行が統一されます。

ポイント
- プロジェクトごとに異なるフォーマッタを使う場合は .vscode/settings.json に上記設定を書き込めば、リポジトリ単位で有効化できます。

4. Kiro の日本語対応設定

Kiro は Steering ファイル（.kiro/steering.yaml）に記述されたパラメータを元に応答言語やプロンプトの振る舞いを決定します。本節ではファイル作成から内容確認までの手順と、よくあるミスへの対策を示します。

4.1 Steering ファイルの配置と記述例

4.2 設定反映の確認手順

1. Kiro のチャットウィンドウを開く（Web / デスクトップどちらでも可）。
2. 「現在の言語設定は？」と入力し、ja が返ってくれば成功。
3. もし英語が返る場合は コンソールログ を確認し、パスが正しく認識されているか Settings → Advanced → Show Debug Logs でエラーメッセージを探す。

5. 仕様駆動開発フローの実践

Kiro が提供する Requirement / Design / Task の自動生成コマンドは、プロジェクト開始時に必要なドキュメントとタスクを瞬時に作り出します。以下では具体的な対話例と、生成結果の活用方法を示します。

5.1 Requirement・Design・Task の自動生成手順

実践例：EC2 自動構築ツール

1. 要件定義
   text
Create Requirement: EC2 インスタンス自動構築ツール

2. 出力例（抜粋）
   
## 要件概要

   1. ユーザーは Web UI からインスタンスタイプ・AMI を選択できる
   2. デプロイ完了後、Slack に通知する
...


3. 設計生成
   text
Generate Design

4. 出力例（抜粋）
   
### クラス構成図

   • class EC2Builder { create_instance(), terminate_instance() }
   • class NotificationService { send_slack_message() }

   ### Terraform (infra/main.tf)
resource "aws_instance" "app" {
ami = var.ami_id
instance_type = var.instance_type
tags = { Name = "auto-ec2-${random_id.id.hex}" }
}


5. タスク化
   text
Define Task

6. 出力例（抜粋）
   | ID | Summary | Assignee | Priority |
|----|---------------------------------------|----------|----------|
| T1 | Web UI の画面設計 | Alice | High |
| T2 | EC2Builder クラス実装 (Python) | Bob | Medium |
| T3 | Slack 通知用 Lambda 関数作成 | Carol | Low |

ポイント
- 各コマンドは 前ステップのコンテキストを保持 したまま実行する必要があります。途中で別トピックに切り替えると生成結果がずれますので、同一チャットスレッドで連続入力してください。

5.2 対話で新規プロジェクト／要件定義書を作成する流れ

具体的なコンソール操作例（VS Code）
1. VS Code の右下に表示された Kiro アイコンをクリック → 「Chat」ウィンドウを開く。
2. 上記コマンドを順番に入力し、出力された Markdown を ファイル → 新規作成 → README.md に貼り付けて保存。

6. よくある初期設定トラブルと対処法

Kiro の導入直後は「日本語化できない」「権限不足で起動できない」などのエラーが頻発します。このセクションでは 具体的な AWS コンソール操作 と VS Code 設定手順を併記し、すぐに復旧できるようにまとめました。

6.1 トラブル別対処フロー

7. まとめ

• IAM Identity Center と最小権限ロールの組み合わせ が Kiro 利用の根幹です。AdministratorAccess は避け、上記カスタムポリシーで kiro:* 等必要最低限のアクションだけを許可しましょう。
• Web・デスクトップ・VS Code 拡張 のいずれも数クリックでインストールでき、SSO 認証さえ完了すれば即座に利用可能です。
• VS Code の日本語化と Format On Save を設定しておくことで、開発者全員が同一の UI とコードスタイルを共有できます。
• Steering ファイル (.kiro/steering.yaml) に language: ja を明示すれば、Kiro の全出力が日本語になるだけでなく、プロンプトカスタマイズも簡単に行えます。
• 仕様駆動開発フロー（Requirement → Design → Task） は Kiro が自動生成したドキュメントをそのままタスク管理ツールやリポジトリにインポートでき、プロジェクト立ち上げのハードルを大幅に低減します。
• トラブルシューティング表 に示したコンソール操作手順を踏めば、よくある設定ミスは即座に解決できます。

以上の手順とベストプラクティスに従うことで、安全かつ日本語対応が完備された Kiro AI IDE 環境 を短時間で構築でき、AI が支援する開発体験を最大限に活用できます。

参考情報