Kiroのステアリングファイル入門：ブログ執筆を効率化する対話型ルール作成

こんにちは。デジタルイノベーション推進室の戦闘員Oです。
前回「AWS KiroでJavaアプリを作ってみた」では、Kiroの基本的な使い方やインストール方法をご紹介しました。

　AWS KiroでJavaアプリを作ってみた | Tech Blog | CRESCO Tech Blog

今回は、Kiroをさらに賢く使うための「ステアリングファイル」という機能について、実際にブログ投稿用のルールを作りながら解説していきます。
この記事を読むことで、Kiroと対話しながらプロジェクト固有のルールを作成し、チーム全体で品質を統一する方法が理解できます。
 

1.    今回のゴール：ブログ投稿用ステアリングファイルの作成
2.    ステアリングファイルの基本
3.    Kiroと対話しながらステアリングファイルを作る
4.    実際に作成したステアリングファイルの解説
5.    ステアリングファイルを使ってみる
6.    他の活用例
7.    まとめ
 

今回は、実際にこのブログ記事を書くために使用している「ブログ投稿用ステアリングファイル」を作成します。

達成したいこと：

•    文体を統一する（「です・ます」調、親しみやすい表現）
•    構成を標準化する（番号付きセクション、表形式での整理）
•    品質チェックを自動化する（チェックリストでのレビュー）
•    チームメンバーが同じ品質で記事を書けるようにする

ステアリングファイルとは？

ステアリングファイルは、Kiroの振る舞いをカスタマイズする設定ファイルです。
プロジェクト固有のルールやガイドラインを記述することで、Kiroが常にそのルールに沿った提案をしてくれるようになります。

なぜステアリングファイルが必要なのか？
Kiroを使っていると、毎回同じような指示を繰り返すことがあります。

例えば：

•    「この記事を親しみやすい文体で書いてください」
•    「設定項目は表形式で整理してください」
•    「セキュリティ注意事項を含めてください」

ステアリングファイルを使えば、これらの指示を一度設定するだけで、以降は自動的に適用されます。
チーム全体で共有すれば、誰が書いても同じ品質の記事が作成できるようになります。
 

2-1. 配置場所とファイル形式

ステアリングファイルは、プロジェクトのルートディレクトリに以下の構造で配置します：

ファイル形式はMarkdownで、front-matter（ファイル先頭のメタデータ）で動作を制御します。

2-2. 3つの適用方法
ステアリングファイルには、3つの適用方法があります。用途に応じて使い分けることができます。

2-3. 基本的な書き方

最もシンプルなステアリングファイルの例：

front-matterでinclusion: alwaysを指定することで、このルールが常に適用されます。

ステアリングファイルの大きな特徴は、Kiroと対話しながら作成できることです。
完璧なルールを最初から考える必要はなく、会話を通じて自然にルールが整理されていきます。

3-1. 目的を伝える
まず、Kiroに何を作りたいのかを伝えます。

ユーザーの依頼：
ブログ投稿用のステアリングファイルを作りたいです。
目的は、クレスコ社のTech Blogへの投稿記事を作成することです。

Kiroは、この依頼を受けて必要な情報を質問してくれます。
 

3-2. 要件を具体化する
Kiroからの質問に答えることで、ルールが明確になっていきます。

具体的な要件の例：

•    投稿先：https://www.cresco.co.jp/blog/entry.html
•    文体：親しみやすく、初心者にも分かりやすい「です・ます」調
•    統一したいポイント：

  - 挨拶から始める
  - 番号付きセクション構成
  - 設定項目は表形式で整理
  - セキュリティ注意事項を含める
 

3-3. 過去の成果物を参考にする
過去の投稿URLをKiroに渡すと、実際の記事を読み込んで文体やスタイルを学習してくれます。

過去の投稿例：
•    SonarQube ServerをAWSで構築
•    Amazon Q DeveloperでJava内OracleSQLをPostgreSQLに変換
•    AWS KiroでJavaアプリを作ってみた

Kiroは、これらの記事を分析して共通パターンを見つけ、ステアリングファイルに反映してくれます。
 

3-4. 効果的なステアリングファイルのポイント
対話を通じて作成する際のポイントをまとめます。

具体例を含める：
抽象的なルールだけでなく、実際の例を示すことで、Kiroが正確に理解できます。

チェックリストを活用：
品質基準をチェックリスト形式で記載することで、レビュー時に活用できます。

段階的に改善：
完璧なルールを最初から作る必要はありません。使いながら改善していくことが重要です。
 

Kiroとの対話を通じて完成したステアリングファイル（.kiro/steering/blog-writing-guide.md）の内容を見ていきましょう。

4-1. 完全なステアリングファイル
以下が、実際に作成したステアリングファイルの全文です。
読者の皆さんも、このファイルをコピーして自分のプロジェクトで使うことができます。

ファイル名： .kiro/steering/blog-writing-guide.md

4-2. 各セクションの役割
それでは、このステアリングファイルの各セクションがどのような役割を果たしているか、詳しく見ていきましょう。

基本情報セクション

なぜこれを明記するのか：
•    Kiroが記事の目的を常に意識できる
•    投稿先を知ることで、そのブログに適した内容を提案できる
•    言語を明示することで、日本語での丁寧な説明を心がける

文体とトーンセクション
ポイント：

•    具体例（「こんにちは。デジタルイノベーション推進室の戦闘員Oです。」）を示すことで、Kiroが同じスタイルを再現しやすくなる
•    「挨拶から始める」という明確な指示により、記事の冒頭が統一される
•    構成の特徴を明記することで、読みやすい記事構造が保たれる

コンテンツの特徴セクション
このセクションにより、Kiroは技術記事として必要な要素を漏らさず含めるようになります。
特に「なぜそうするのか」の説明を加えることで、読者の理解が深まります。

品質チェックポイントセクション
チェックリストの活用：
このチェックリストは、記事のレビュー時にKiroが自動的に確認してくれます。
後ほど、実際にこのチェックリストを使った自動レビューの方法をご紹介します。

過去の投稿例セクション
過去の投稿を参照する理由：

•    Kiroが実際の記事スタイルを学習できる
•    一貫性のある文体を保てる
•    成功事例を参考にできる

このように、各セクションには明確な役割があり、それぞれがKiroの振る舞いに影響を与えています。

実際にステアリングファイルの効果を検証してみましょう。
同じ内容について、ステアリングファイル適用前と適用後で記事を書いてもらい、違いを比較します。

5-1. 適用前/適用後の比較
テーマ： 「Kiroのステアリングファイルについて」という簡単な説明記事

ステアリングファイル適用前の記事

問題点：
•    挨拶がない
•    箇条書きのみで説明が簡潔すぎる
•    表形式での整理がない
•    「なぜそうするのか」の説明がない
•    読者が実際に試せる具体例が少ない
 

ステアリングファイル適用後の記事
（この記事自体がステアリングファイル適用後の例です！）

改善された点：

•    「こんにちは。デジタルイノベーション推進室の戦闘員Oです。」という挨拶
•    明確な番号付きセクション構成
•    表形式での設定項目整理
•    各ステップに「なぜそうするのか」の説明
•    実際の対話例やコード例が豊富
•    読者が実際に試せる具体的な手順
 

5-2. 比較表でまとめる

5-3. チェックリスト機能での記事レビュー自動化

ステアリングファイルに記載した品質チェックポイントを使って、実際の記事をKiroにレビューしてもらいましょう。

実例：前回の記事をレビュー

前回公開した「AWS KiroでJavaアプリを作ってみた」という記事を、今回作成したステアリングファイルを使ってレビューしてもらいました。

Kiroへのプロンプト：

Kiroは、ステアリングファイルに記載されたブログ投稿ガイドラインに基づいて、記事を詳細にレビューしてくれます。

レビュー結果の例：

•    良い点：明確な構成、スクリーンショット活用、実践的な内容
•    改善点：導入部分の充実、セクション構成の完成、技術的な説明の追加
•    具体的な修正提案：挨拶文の追加、まとめセクションの追加、など
 

このように、ステアリングファイルがあれば、既存の記事に対しても一貫した基準でレビューができます。
 

レビューの活用方法：
•    記事を書き終えたら、Kiroにレビューを依頼
•    ステアリングファイルのチェックリストに沿って自動確認
•    問題があれば具体的な修正提案を受ける
•    修正後、再度レビューして品質を確認

レビューのメリット：

•    記事の品質が安定する
•    レビュー時間が大幅に短縮される
•    見落としがちなポイントも自動チェック
•    過去の記事も同じ基準で評価できる
 

これにより、チーム全体で一貫した品質の記事を作成できるようになります。

ブログ投稿以外にも、ステアリングファイルはさまざまな場面で活用できます。

6-1. コーディング規約の統一
Java開発の例：

適用場面：

•    チーム開発でのコーディングスタイル統一
•    新メンバーへのオンボーディング
•    レビュー時の指摘事項削減

6-2. プロジェクト固有の知識共有
API設計の例：

適用場面：
•    プロジェクト固有のルール共有
•    設計思想の統一
•    ドキュメント代わりの活用

6-3. ステアリングファイルの限界
ステアリングファイルは強力な機能ですが、万能ではありません。

できること：

•    ✓ ガイドラインの提示
•    ✓ コード生成時のルール適用
•    ✓ 文体や構成の統一
•    ✓ チーム知識の共有

できないこと：

•    ✗ 既存コードの自動検証
•    ✗ 外部ツールの実行
•    ✗ 実際のテストやスキャン
•    ✗ コードの自動修正

重要なポイント：
> ステアリングファイルは「ガイドライン」を提供するもの。
> 実際のコード検証や外部ツール連携には「Kiro Power」が必要です！

次回予告：
次回の記事では、「Kiro Power」を使って外部ツールと連携し、
実際のコード検証を自動化する方法をご紹介します。
ステアリングファイルとの違いを実感していただけると思います！
 

今回は、Kiroのステアリングファイル機能について、実際にブログ投稿用のルールを作りながら解説しました。

ステアリングファイルで実現できたこと：

•    Kiroと対話しながら、自然にルールを作成できた
•    ブログ執筆の文体と構成を統一できた
•    チェックリストによる自動レビューで品質が向上した
•    チームメンバーと共有することで、誰が書いても同じ品質を保てる
 

ステアリングファイルの特徴：

•    配置場所：`.kiro/steering/*.md`
•    形式：Markdown + front-matter
•    3つの適用方法：always / fileMatch / manual
•    対話しながら作成できる
•    Gitで簡単に共有できる
 

ステアリングファイルの限界：

•    外部ツールとの連携は難しい
•    実際のコード検証には別の仕組みが必要
•    「ガイドライン提示」はできるが「自動実行」はできない
 

次のステップ：
次回の記事「ステアリングファイルとの違いを理解する：IaC検証Powerの実装」では、
Kiro Powerを使って外部ツール（cfn-lint、cfn-nag）と連携し、
CloudFormationのセキュリティチェックを自動化する方法をご紹介します。
ステアリングファイルとKiro Powerを組み合わせることで、
さらに強力な開発環境を構築できます。

読者の皆さんへ：
まずは、自分のプロジェクトでステアリングファイルを作ってみてください。
完璧なルールを最初から作る必要はありません。
Kiroと対話しながら、少しずつ改善していくことができます。
チーム開発でルールや規約を統一したい方、
毎回同じ指示を繰り返すのが面倒だと感じている方は、
ぜひステアリングファイルを試してみてください。
次回もお楽しみに！
 

参考リンク

• 前回の記事：AWS KiroでJavaアプリを作ってみた

この記事で作成したファイル