0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Kiro IDE で複数の要件(Spec)を登録するとどうなる? 並行管理と一覧化のやり方(AI-SDD 入門)

0
Posted at

はじめに

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/ 配下に 要件ごとのディレクトリ が自動生成されます。

スクリーンショット 2026-08-04 142848-specs-file.png

ポイントは次の 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*
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?