Kiro IDE 使い方入門｜インストールからスペック駆動開発まで

Kiroのインストールから初回起動まで

KiroはAWSが開発したAI統合開発環境(IDE)で、VS Codeに似たインターフェースにエージェント型のコーディング機能を組み合わせたツールだ。インストールから初回起動までの流れは次のとおり。

Kiro公式サイトから自分のOS(Windows / macOS / Linux)に合ったインストーラーをダウンロードする。
インストーラーを実行し、一般的なアプリと同じ手順でインストールを進める。VS Codeを使ったことがあれば画面構成に戸惑うことはないはずだ。
インストールが終わったらKiroを起動する。ログイン画面が表示される。

ログイン(サインイン)方法

Kiroにはいくつかのログイン方法が用意されている。

AWS Builder ID: AWSアカウントとは別に無料で作成できる個人ID。AWSアカウントがなくてもメールアドレスだけで発行できる。
ソーシャルログイン: Googleアカウントなどで簡単ログイン。
AWS IAM Identity Center: 会社でAWSの組織アカウントを使っている場合、管理者が設定したSSOでログインする。

初めて使うならAWS Builder IDで登録するのが一番早い。メールアドレスを入力して認証コードを受け取り確認したあと、名前とパスワードを設定すれば数分でアカウントが作られる。ログインが完了するとKiroのメイン画面が開き、左側にファイルエクスプローラー、中央にエディター、右側または下部にAIチャット/エージェントパネルが配置される。VS Codeを使ったことがあれば、ショートカットのほとんど(ファイル保存はCtrl+S、コマンドパレットはCtrl+Shift+Pなど)がそのまま使えるので馴染むのが早い。

最初のプロジェクトを作る(Create New Project)

Kiroで新規プロジェクトを始める方法は2つある。

方法1 — 空のフォルダーを開く

スタート画面で「Open Folder」を選び、あらかじめ用意しておいた空のフォルダーを開く。そのあとチャットパネルに作りたいプロジェクトを自然言語で説明すると、Kiroがファイル構成を提案して作ってくれる。

方法2 — テンプレートから始める

スタート画面の「New Project」または「Create New Project」ボタンを押すと、言語/フレームワーク別のテンプレート一覧が表示される。Python、Node.js、Reactなどよく使われるスタックの基本テンプレートが用意されており、ひとつ選ぶと基本のフォルダー構成と設定ファイル(例: requirements.txt、package.json)が自動生成される。

プロジェクトを開くと下部またはサイドバーにチャット入力欄がある。ここに「ToDo管理APIをFastAPIで作って」のように作業内容を文章で入力すると、エージェントが作業を開始する。

Kiroの中核概念1 — スペック(Spec)

Kiroを他のAIコーディングツールと分ける一番の特徴がスペック(仕様書)ベースのワークフローだ。チャット欄に機能のリクエストを入力すると、Kiroはすぐにコードを書かず、まず3つのドキュメントを順番に作って見せてくれる。

requirements.md — 何を作るのかを、ユーザーストーリーと受け入れ基準としてまとめたドキュメント。「ユーザーはToDoを追加できる」「完了したToDoはリストに取り消し線で表示される」といった形で具体化される。
design.md — どう作るのかを、アーキテクチャやデータモデル、APIエンドポイント、フォルダー構成などとしてまとめた設計ドキュメント。
tasks.md — 実際の実装手順をチェックリストに分解したタスク一覧。各項目を終えるたびにチェックが付くので、進捗が一目でわかる。

これらのドキュメントはエディター上でMarkdownファイルとしてそのまま閲覧・編集できる。各段階でユーザーが「このまま進める」を押すか、気になる部分を直接修正して承認すると、次の段階に進む。tasks.mdが承認されて初めて実際のコード生成が始まる。この手順のおかげで、要件を誤解したまま見当違いのコードが大量に生成されてしまう事故を減らせる。

Kiroの中核概念2 — ステアリング(Steering, Instructions)

スペックが「機能ひとつひとつ」に対する計画だとすれば、ステアリングファイルは「プロジェクト全体」に適用されるルールだ。検索流入で多い「kiro instructions」は、このステアリング機能を指している。

プロジェクトルートの.kiro/steering/フォルダーにMarkdownファイルを置いておくと、Kiroはコードを生成するたびにその内容を必ず参照する。例えば次のような内容を書いておける。

コーディング規約: 「関数名は常にスネークケースで書く」
アーキテクチャ原則: 「データベースへのアクセスは必ずrepositoryレイヤーを経由する」
技術スタックの制約: 「外部へのHTTPリクエストはrequestsではなくhttpxを使う」
テストのルール: 「新しい関数を追加したら必ず対応するpytestのテストを書く」

ステアリングファイルは複数に分けて管理でき、特定のファイルパターンにだけ適用されるよう範囲を指定することもできる。例えばbackend/フォルダー用のルールとfrontend/フォルダー用のルールを別ファイルに分けておけば、Kiroは作業中の領域に合ったルールだけを適用する。この機能をうまく使えば、毎回チャット欄に「こう書いて、これはやらないで」と繰り返し入力する必要がなくなる。

Pythonプロジェクトで実際に試してみる

検索でよく調べられる「kiro python」の使い方を実際の手順としてまとめると次のとおり。

1. プロジェクト作成

スタート画面で「New Project」を選び、Pythonテンプレートを選ぶ。あるいは空のフォルダーを開いてチャット欄に「Pythonでコンソールベースの家計簿プログラムを作りたい」のように入力してもいい。

2. 仮想環境の準備

Kiroの下部には統合ターミナルがある。VS Codeと同じようにここでコマンドを直接実行できる。

python -m venv venv
venv\Scripts\activate   # Windows
source venv/bin/activate  # macOS/Linux

3. 要件をチャットで伝える

チャットパネルに具体的にリクエストする。例:「支出項目を入力してCSVに保存し、月ごとの合計を出力するCLIプログラムを作って。入力値の検証も含めて」。Kiroはこれをもとにrequirements.mdをまず生成して画面に表示する。

4. requirements.mdを確認する

生成された要件ドキュメントを読み、抜けている部分があれば直接修正するか、チャットで「返金(マイナス金額)の入力も許可して」のようなフィードバックを送る。問題なければ承認して次の段階に進む。

5. design.mdを確認する

設計ドキュメントには通常次のような内容が含まれる。

ファイル構成(例: main.py、expense.py、storage.py)
データモデル(支出項目のフィールド: 日付、金額、カテゴリ、メモ)
関数/クラス設計の概要

ここで使いたいライブラリ(例: pandasではなく標準ライブラリのcsvモジュールを使う)を指定したいなら、この段階でリクエストするのが効率的だ。

6. tasks.mdを承認してコード生成

タスク一覧が作られ承認すると、Kiroが各タスクを順番に進めながら実際の.pyファイルを書いていく。進行中はエディター上でリアルタイムにファイルが埋まっていく様子を見ることができ、タスクが終わるたびにtasks.mdのチェックボックスが自動で更新される。

7. 実行とデバッグ

ターミナルからそのまま実行してみる。

python main.py

エラーが出たら、エラーメッセージをコピーしてチャット欄に貼り付け「このエラーを直して」とリクエストすると、Kiroが関連ファイルを探して原因を分析し修正案を提示する。このとき修正範囲が大きい場合、自動で新しいタスク項目がtasks.mdに追加されることもある。

8. テストを追加する

ステアリングファイルに「テストコードを必ず書く」というルールをあらかじめ入れておけば、新しい機能をリクエストするたびにpytestベースのテストファイルも一緒に生成される。そうでなければ「expense.pyに対するpytestのテストを書いて」と別途リクエストすればいい。

よくつまずくポイントと解決のヒント

スペックドキュメントの承認段階が面倒に感じるとき: 簡単なスクリプト1本程度の作業なら、チャットで「スペックなしで直接コードを書いて」とリクエストすると簡易モードで進むことが多い。ただしこの場合は設計レビューなしでいきなりコードが出てくるので、成果物をより念入りに確認する必要がある。
クレジットの減りが早く感じるとき: スペックドキュメントの生成とコード生成はそれぞれ別のリクエストとして処理されるため、大きな機能を一度にリクエストするより、作業を小さく分けて順番にリクエストするほうがクレジット管理に有利だ。
既存プロジェクトにKiroを導入するとき: すでにコードがあるリポジトリを開いたら、チャットで「このプロジェクトの構成を分析して」とリクエストし、先にコードベースを把握させるのがいい。そのあとステアリングファイルに既存プロジェクトの規約を整理しておくと、以降の作業の一貫性が大きく向上する。
チームで一緒に使うとき: .kiro/フォルダー(スペックとステアリングファイルを含む)をGitリポジトリに一緒にコミットしておくと、チームメンバー全員が同じ設計ドキュメントとルールを共有しながら作業できる。

ショートカットと画面構成を覚える

KiroはVS Code系のUIをそのまま採用しているので、これまで使っていたショートカットのほとんどがそのまま通用する。

Ctrl+P(macOSはCmd+P): ファイルをすばやく開く
Ctrl+Shift+P: コマンドパレットを開く。Kiro専用のコマンド(新規スペック作成、ステアリングファイルを開く、など)もここで検索できる
Ctrl+バッククォートキー: 統合ターミナルの開閉
Ctrl+B: サイドバー(ファイルエクスプローラー)の開閉

チャット/エージェントパネルは通常右側のサイドバーか下部パネルで開けるほか、コマンドパレットで「Kiro: Open Chat」のようなコマンドを検索してもすぐに開く。複数の会話セッションをタブのように分けて管理できるので、機能ごとに会話を分けておくと、あとで特定の機能を手直しするときに関連する会話履歴をすばやく見つけられる。

拡張機能との連携

KiroはVS Codeの拡張機能マーケットプレイスと完全に同じではないが、独自の拡張機能と一部の互換拡張機能をサポートしている。Python開発なら、リンター(例: ruff、flake8)やフォーマッター(black)の拡張機能をインストールしてコードスタイルを自動で揃えられるし、Kiroエージェントがコードを生成する際もこうしたリントルールをステアリングファイルに明記しておけば、最初からルールに沿ったコードを出してくれる。Git連携も標準で組み込まれているので、サイドバーで変更内容を確認してコミットメッセージを書くことができ、エージェントに「ここまでの変更内容でコミットメッセージを書いて」とリクエストすることも可能だ。

MCP(外部ツール連携)で拡張する

KiroもModel Context Protocol(MCP)をサポートしており、データベースの照会、外部API呼び出し、社内ドキュメント検索といった外部ツールをエージェントに接続できる。設定ファイル(.kiro/settings/mcp.json形式)に使用するMCPサーバーの情報を登録しておくと、スペック作成やコード生成の過程でエージェントが必要に応じてそのツールを直接呼び出す。例えば社内のAPIドキュメントを提供するMCPサーバーを接続しておけば、「このAPI仕様に合わせてクライアントコードを作って」というリクエストに対して、実際の最新ドキュメントを参照して正確なコードを生成できる。

既存のコードベースに後からスペックを適用する

すでにある程度完成したプロジェクトにKiroを導入する場合、最初からスペックドキュメントを書き直す必要はない。新しく追加する機能の単位だけスペックを適用すればいい。例えば既存のFlaskプロジェクトにログイン機能を新しく追加するなら、チャットで「ログイン/会員登録機能を追加したい。既存のプロジェクト構成を踏まえてスペックを作って」とリクエストする。Kiroはまず既存のコードをスキャンしてフレームワーク、フォルダー構成、コーディングスタイルを把握したうえで、それに合わせてrequirements.mdとdesign.mdを作成する。こうして新機能の単位でスペックを積み重ねていくと、プロジェクトが大きくなるほど.kiro/specs/フォルダーの中に機能ごとの設計履歴が自然に蓄積されていく。

複数人で同じプロジェクトを作業するとき

チームプロジェクトでは.kiro/フォルダーをGitで一緒に管理するのがポイントだ。あるメンバーが新機能のスペックを作成してコミットしておけば、他のメンバーは別途説明を聞かなくてもrequirements.mdとdesign.mdを読むだけで、何を、なぜそう作ったのかを把握できる。コードレビューの段階でも「この実装はdesign.mdの設計と一致しているか」を基準にレビューすると、議論がずっと具体的に進む。ステアリングファイルも同様にコミットしておけば、新しく加わったメンバーがKiroを初めて開いたときからチームのコーディング規約を自動的に守るようになる。

バージョン管理とGit連携

Kiroのソースコントロールパネルは、VS CodeのGit統合と同じ方式で動作する。変更されたファイルが左側のサイドバーに表示され、ファイルごとにdiffを確認したあとステージング、コミット、プッシュを行える。エージェントが複数のファイルを一度に修正した場合は、diffビューで実際にどの行が変わったのかひとつひとつ確認する習慣をつけることが重要だ。特にtasks.mdで複数のタスクが順番に進んだ場合、コミットを作業単位で細かく分けておくと、あとで特定の変更だけを戻したいときにやりやすくなる。

まとめ

Kiroを初めて使うときのポイントは3つだ。第一に、AWS Builder IDで登録し、テンプレートか空のフォルダーでプロジェクトを始める。第二に、チャットで機能をリクエストするとrequirements → design → tasksの順でドキュメントが作られるので、コードがすぐに出てこなくても慌てず、各段階を確認しながら承認する。第三に、繰り返し使うルールは.kiro/steering/フォルダーにまとめておけば、毎回同じ指示を繰り返さなくて済む。Pythonプロジェクトでも他の言語でも、この流れは変わらない。この構造に慣れると、ひとりで開発するときも設計ドキュメントが自然に残るのが、Kiroの実務上いちばん大きなメリットだ。

Kiro IDE 使い方完全ガイド：インストールからスペック・ステアリングまで