はじめに
Kiro IDE の基本的な使い方については、前回までの記事で紹介してきました。
今回は 「複数の要件(Spec)を登録できるのか、登録するとどうなるのか」 をテーマに、実際の画面キャプチャを交えて解説します。
「1 つのプロジェクトで、複数の機能追加やバグ修正を並行して進めたい」というのは、開発現場ではごく普通に起こることです。
Kiro がそれをどう管理してくれるのか、実際に試した結果を、画像や Markdown と共に紹介します。
1. 複数の要件は登録できる? → できます
結論から言うと、Kiro では 複数の要件(Spec)を並行して登録・管理 できます。
Specs ペインに専用の追加ボタンがあるわけではありません。
チャットで Kiro に「これを要件として追加して」と依頼する ことで、新しい Spec が作られます。
1 回チャットで依頼するたびに、Kiro はそれを独立した要件として扱ってくれます。
そのため、1 つのプロジェクトに機能追加の Spec とバグ修正の Spec が同時に存在していても問題ありません。
一度に複数の要件を追加することもできます。
今回も、一度の依頼で複数の要件を登録しました。
依頼の例です。
潜在的なバグを抽出して、新しく要件として追加してほしい
xxx, yyy を別々の要件として追加してほしい
このようにチャットで依頼するだけで、Kiro が内容を解析し、新しい Spec として登録してくれます。
2. 登録すると何が起きる? → .kiro/specs/ 配下にディレクトリが作られる
新しい Spec を登録すると、プロジェクト直下の .kiro/specs/ 配下に 要件ごとのディレクトリ が自動生成されます。
ポイントは次の 2 つです。
-
機能追加(Feature Spec) の場合は、
requirements.md(ユーザーストーリーと受け入れ基準)が作られます。 -
バグ修正(Bugfix Spec) の場合は、
bugfix.md(現状の挙動・期待する挙動・影響範囲の分析)が作られます。
このように、要件の性質によって出力されるファイル名が変わります。
Kiro が「作るもの」と「直すもの」を明確に区別して管理していることの表れです。
これらのファイルはただの Markdown なので、Git でバージョン管理 できます。
チームメンバーとレビューしながら育てていくことも可能です。
また、上の画像でわかるように、これらの要件はまだ「要件として登録しただけ」の状態で、設計には進んでいません。
それぞれの要件ごとに Go を出してから、設計、実装へと進めることができます。
3. 要件が増えてきたら「一覧化」を Kiro に頼む
Spec の数が増えてくると、「今どんな要件があって、どこまで進んでいるのか」を俯瞰したくなります。
そんなときは、チャットで Kiro に一言頼むだけです。
すべての要件の一覧を、ステータス管理できる形式で作って
すると Kiro は各 Spec の状況を解析し、チェックボックスやステータス付きの要件一覧 を Markdown 形式で作成してくれます。
完了したものにはチェックが入り、未着手・進行中のものは空欄のままになります。
プロジェクト全体の進捗が一目でわかるようになります。
実際に生成された一覧のイメージは、記事の末尾に掲載しています。
4. 「進捗のたびに自動更新したい」と思ったら
ここまでで、Spec の登録・管理・一覧化ができるようになりました。
次に出てくる欲求は、「タスクが進むたびに、この一覧を自動で更新してほしい」 ではないでしょうか。
毎回手動でチェックを付け直すのは、地味に手間です。
実は Kiro には、「イベントが起きたら自動でアクションを実行する」仕組みとして、.kiro/hooks/(Agent Hooks)という機能があります。
この続きについては、別の記事で紹介する予定です。
まとめ
- Kiro では、複数の要件(Spec)を並行して登録できます。
- 登録すると、
.kiro/specs/配下に要件ごとのディレクトリが作られます。 - 機能追加は
requirements.md、バグ修正はbugfix.mdとして出力されます。 - Kiro に頼むと、ステータス付きの要件一覧を作ってくれます。
- 進捗の自動更新には
.kiro/hooks/を使います(→ 次回!)。
付録: 生成された要件一覧の例(specs-status.md)
以下は、Kiro に「すべての要件の一覧を、ステータス管理できる形式で作って」と依頼して生成された Markdown のイメージです。
プロジェクト固有の名称は、一般的な内容に置き換えています。
# Specs ステータス一覧
このドキュメントは `.kiro/specs/` 配下の全 Spec の進捗を追跡します。
> 凡例: ✅ 完了 / 🚧 作業中 / ⬜ 未着手
---
## 一覧
| Spec名 | 種別 | Requirements | Design | Tasks | 概要 |
|--------|------|:------------:|:------:|:-----:|------|
| [ui-bug-fixes](#ui-bug-fixes) | 🐛 Bugfix | ✅ | ⬜ | ⬜ | 型変換漏れ・不要なクエリ発行・特定の値が選択できない 3 件のバグ修正 |
| [ui-ux-polish](#ui-ux-polish) | ✨ Feature | ✅ | ⬜ | ⬜ | アクセシビリティ・表記統一・空状態表示など 5 項目の UX 改善 |
| [ui-navigation-header](#ui-navigation-header) | ✨ Feature | ✅ | ⬜ | ⬜ | 戻るボタン・ユーザーイニシャル表示などのヘッダー改善 |
---
*最終更新: 2026-08-04*
