Contents
1. Kiro の概要と利用前提条件
1‑1. Kiro が提供する主な機能
- AI IDE:対話形式で要件入力 → タスク自動生成 → コード雛形作成までを一括で実行できる開発支援環境。
- Claude sonnet‑4.5(Anthropic) をバックエンドに採用し、プロンプトベースのタスク分解やコード提案を高速に行う。
- ステアリング機能:対話中に取得したメモやアウトプットを保持し、別コマンドで再利用できる。
⚠️ 公式サイト(https://aws.amazon.com/jp/kiro/)では「無料枠」の提供が案内されていますが、トークン上限や対象機能は変更され得ます。最新情報は必ず公式ページをご確認ください。
1‑2. 必要なアカウント・設定
| 必要項目 | 用途 | 設定手順の概要 |
|---|---|---|
| AWS アカウント | Bedrock や MCP へのアクセス権限取得に必須 | AWS コンソールでメール認証とクレジットカード情報を入力して作成 |
| Builder ID | Kiro の認証情報として使用 | https://aws.amazon.com/jp/builders/ → 「Sign in」→「Create Builder ID」から取得 |
| 日本語 UI 設定(任意) | 対話画面やエラーメッセージを日本語化 | Chrome 拡張機能 CloudBuilders の設定で Language = Japanese を選択 |
以上の三点が揃うと、Kiro の Web UI と CLI が日本語表示になるため、英語に不慣れな方でも快適に利用できます。
2. インストール手順とプロジェクト初期化
2‑1. フォルダ構成のベストプラクティス
|
1 2 3 4 5 |
kiro-workspace/ ├─ src/ # アプリケーション本体(JavaScript / TypeScript 等) ├─ docs/ # 設計書・メモ └─ kiro-config.yml # Kiro の設定ファイル(CLI が自動生成) |
- 根拠:Kiro CLI はカレントディレクトリをプロジェクトルートとして認識します。統一された構造にすると、ステアリングや MCP 連携時のパス指定ミスが減ります。
2‑2. Kiro CLI のインストール
|
1 2 |
npm install -g @aws/kiro-cli # npm(Node.js ≥14 が必須)でグローバルインストール |
- 注意:公式ドキュメントでは npm 配布が推奨されています。Homebrew 等の代替手段は将来的にサポート対象外になる可能性があります。
- バージョン確認(例)
|
1 2 |
kiro --version # → v<MAJOR>.<MINOR>.<PATCH> |
v<MAJOR>.<MINOR>.<PATCH>は執筆時点での最新安定版です。公式リリースページで随時確認してください。
2‑3. プロジェクトの初期化と IDE 起動
|
1 2 3 4 5 |
cd kiro-workspace kiro init # kiro-config.yml が自動生成される code . # VS Code でフォルダ全体を開く(任意) kiro open # ブラウザベースの Kiro UI を起動 |
kiro initはデフォルト設定と空のメモ領域を作成し、手動ファイル作成の手間を省きます。kiro openで表示される画面は 対話型プロンプト が中心です。ここに要件や質問を入力して AI に処理させます。
3. 要件入力とタスク自動生成の実践テクニック
3‑1. 効果的な要件記述例(ToDo アプリ)
「シンプルな ToDo アプリを作りたいです。ユーザーはタスクを追加・編集・削除でき、完了したタスクは別リストに移動します。また、ローカルストレージでデータ永続化したいです。」
- ポイント
- 「何ができるか」だけでなく「どのように保存するか」まで具体的に書く。
- 主語(ユーザー)と操作対象(タスク)を明示すると、AI が抽出すべき要素を正しく認識します。
3‑2. プロンプトテンプレート(目的・制約・出力フォーマット)
|
1 2 3 4 |
[目的] {プロジェクト名} の開発に必要な作業項目を洗い出す [制約] ・使用言語は {言語} ・フロントエンドは {フレームワーク} ・デプロイ先は AWS [出力フォーマット] • 番号: タスク概要 (優先度: High/Medium/Low) • 必要なファイル・ディレクトリ |
- 使用例
|
1 2 3 4 |
[目的] ToDo アプリの開発タスク洗い出し [制約] ・言語は TypeScript ・フロントは React 18 ・デプロイは AWS Amplify [出力フォーマット] • 1: プロジェクト初期化 (High) – npm init, tsconfig.json 作成 |
- 効果:
[]で区切ったセクションは Kiro のパーサがキーとして認識し、出力の一貫性を保ちます。
3‑3. タスク一覧(生成例)
| No | タスク概要 (優先度) | 必要ファイル・ディレクトリ |
|---|---|---|
| 1 | プロジェクト初期化 (High) | package.json, tsconfig.json |
| 2 | データモデル設計 (Medium) | src/models/Task.ts |
| 3 | CRUD API 実装 (High) | src/api/taskApi.ts |
| 4 | UI コンポーネント作成 (High) | src/components/TaskList.tsx, AddTaskForm.tsx |
| 5 | ローカルストレージ永続化 (Medium) | src/utils/storage.ts |
| 6 | 完了タスクのフィルタリング機能 (Low) | src/components/CompletedTasks.tsx |
上記はテンプレートに沿って生成された例です。実際の出力は入力した要件や制約に応じて変化します。
4. ステアリング機能と MCP(Managed Cloud Platform)連携
4‑1. メモ取得 → タスク変換までの自動フロー
- 対話 UIで要件を入力し、「メモに保存」ボタンをクリック。
- ターミナルから以下コマンドを実行
|
1 2 |
kiro steer --source memo --target task |
-
Kiro がメモ内容を解析し、先述のテンプレート形式でタスク一覧を生成して標準出力に表示。
-
メリット:手動コピー・ペーストが不要になるため、要件変更時の再利用がシームレスです。
4‑2. MCP へのタスク自動登録手順
| 手順 | 内容 | 設定例 |
|---|---|---|
| ① IAM ロール作成 | MCPTaskWrite ポリシー(mcp:CreateTask, mcp:UpdateTask)を付与したロールを作成し、Builder ID に紐付ける。 |
AWS コンソール → IAM → ロール作成 |
| ② API トークン取得 | MCP コンソールの「開発者設定」からトークンを生成。 | MCP_TOKEN 変数に保存 |
| ③ Kiro 設定ファイルへ追記 | kiro-config.yml にエンドポイントとトークン参照を追加。 |
yaml mcp: endpoint: https://mcp.aws.example.com token: ${MCP_TOKEN} |
| ④ タスクプッシュ | 生成済みタスクを MCP に送信するコマンドを実行。 | kiro push --to mcp |
| ⑤ 進捗更新 | 作業中や完了時にステータスを変更できる。 | kiro update --task-id <ID> --status InProgress |
- 注意点:トークンは平文でリポジトリに残さないよう、AWS Secrets Manager に格納し
${SECRET_NAME}形式で参照するのがベストプラクティスです。
4‑3. 権限・機密情報取り扱いのベストプラクティス
- 最小権限の原則:Builder ID に付与するロールは
MCPTaskWriteのみ。不要な S3 アクセスや管理権限は除外します。 - シークレット管理:API トークンは Secrets Manager に保存し、Kiro 設定では
${SECRET_NAME}で参照。Git への漏洩防止が必須です。 - 監査ログの有効化:IAM の CloudTrail ログをオンにして、タスク作成・更新操作を定期的にレビューします。
5. フルフロー実践例(ToDo アプリ開発)
| フェーズ | 操作内容 | 主なコマンド/画面 |
|---|---|---|
| 1️⃣ 要件入力 | Kiro UI に自然言語で要件を記載 | kiro open → 対話ウィンドウ |
| 2️⃣ メモ保存 | 「メモに保存」ボタンで対話内容保持 | - |
| 3️⃣ タスク生成 | ステアリングでタスク化 | kiro steer --source memo --target task |
| 4️⃣ MCP 設定 | IAM ロール・トークンを 1 回だけ設定 | AWS コンソール |
| 5️⃣ タスクプッシュ | 生成タスクを MCP に送信 | kiro push --to mcp |
| 6️⃣ 進捗更新 | 担当者がステータス変更 | kiro update --task-id <ID> --status Done |
- 結果:要件入力からタスク登録、進捗管理まで全工程が CLI と UI の組み合わせだけで完結。Excel や外部チケットツールへの二重入力は不要です。
6. プロンプト改善テクニックと落とし穴
6‑1. 改善ポイントチェックリスト
| 項目 | 推奨アクション |
|---|---|
| 具体性 | 「ユーザーがタスクを追加」だけでなく「タイトル・期限を設定可能」と明記 |
| 段階的指示 | 大きな要件は「① データモデル設計 ② UI 実装 ③ 永続化」のように分割 |
| 出力フォーマット統一 | 「番号: タスク概要 (優先度)」と固定し、スクリプトでパースしやすくする |
| 変数活用 | プロジェクト名・言語は ${PROJECT_NAME} などプレースホルダー化して再利用性を確保 |
6‑2. よくある失敗と回避策
| 問題 | 原因 | 回避策 |
|---|---|---|
| 曖昧な要件 | AI が余計なタスクを生成 | 「誰が」「何を」「どうやって」の 3 要素で具体的に記述 |
| プロンプト長過ぎ | トークン上限超過でエラー | 必要情報だけ抽出し、サブタスクは別回で生成 |
| 権限不足 | MCP へプッシュできない | IAM ポリシーに mcp:CreateTask と mcp:UpdateTask を必ず付与 |
7. まとめと次のアクション
- Kiro は AWS の Bedrock 上で動作する AI IDE で、Claude sonnet‑4.5 を利用した要件分解が可能です。
- 利用開始に必要なのは AWS アカウント + Builder ID のみで、設定さえ済ませれば日本語 UI が利用できます。
- インストールは npm グローバル、プロジェクトは
kiro-workspace/配下にシンプル構成 すると管理が楽です。 - 要件入力 → ステアリングでメモ取得 → タスク自動生成 → MCP へプッシュ のフローを覚えると、開発プロセス全体の自動化が実現します。
- プロンプトは「目的・制約・出力フォーマット」のテンプレート化 が品質向上の鍵です。
- 権限設定・シークレット管理は最小権限と Secrets Manager の併用で安全に 行い、CloudTrail で監査ログを取得しましょう。
今すぐできること
- AWS コンソールで Builder ID を作成し、npm install -g @aws/kiro-cliを実行。
-kiro-workspace/ディレクトリを作り、上記テンプレートプロンプトで要件入力を試す。
- 生成タスクをローカルで確認し、問題なければ MCP 設定に進む。
このガイドに沿って手順を実践すれば、AI を活用したタスク管理とコード自動生成がスムーズに組み込めます。ぜひご自身のプロジェクトで効果をご体感ください。