はじめに
AIエージェントに対して指示を出すとき、多くの場合は次のような依頼になります。
- 調査してまとめる
- 資料を作成する
しかし、この方法では期待した成果に届かないことが多くあります。理由は、作業の進め方が定義されていないためです。
問題の本質
AIは回答を生成することは得意ですが、プロジェクトを進めることは指示しないとできません。
人間が業務を進める場合は、次のような流れを自然に実行します。
- 調査する
- 構造を考える
- 分担する
- 作成する
- レビューする
- 修正する
一方でAIは、この流れを明示しない限り、1回の出力で処理を終えます。
解決アプローチ
有効な方法は、プロンプトとテンプレートを組み合わせて渡すことです。
AIに対して、やりたいことと、どのように進めるかの両方を与えます。
全体構成
AIに渡す内容は2つです。
1. やりたいこと（プロンプト本体）
（ここにテーマを書く）
例：
オンデマンド交通サービスの仕組みを調査し、導入検討のためのドキュメントを作成してください。
2. 実行方法（テンプレート）
後述のテンプレートをそのまま添付します。
実際の使い方
（ここにやりたいことを書く）
以下のテンプレートに従ってプロジェクトとして実行してください：
（テンプレート全文を貼る）
この方法が機能する理由
テンプレートは単なる指示ではなく、作業プロセスそのものを定義しています。
AIに対して何を作るかではなく、どのように進めるかを与えることで、出力の質と再現性が向上します。
テンプレートの設計思想
構造を先に作る
最初にREADMEなどの構造を設計させることで、全体像を固定します。
分割して処理する
役割ごとに処理を分割します。
- 情報収集
- 構造設計
- ビジネス視点整理
- 技術設計
- レビュー
品質基準を定義する
各ドキュメントに含める要素を指定します。
- 想定読者
- 前提条件
- 用語定義
- 図解
- 比較
- リスク
レビューと改善を組み込む
自己評価と修正を繰り返すことで、完成度を高めます。
完了条件を定義する
終了基準を明確にすることで、中途半端な状態での終了を防ぎます。
実務での変化
従来の方法では、単発のアウトプットになりがちです。
この方法を使うと、次のように変わります。
- ドキュメント群として整理される
- 情報の深さと網羅性が安定する
- 継続的な改善が可能になる
- 実務にそのまま利用できる
よくある失敗
- テンプレートを使わない
- 品質基準を定義しない
- レビュー工程を省略する
- ループ回数を制御しない
応用範囲
- システム設計
- 事業企画
- 技術調査
- 運用改善
- 移行計画
重要な考え方
AIに回答を求めるのではなく、作業を実行させるという視点が重要です。
テンプレート
以下をそのままAIエージェントに渡して使用します。
上記テーマについて以下の手順でプロジェクトとして実行してください。
# 1. 情報収集
Web検索により以下を必ず調査すること：
- 国内事例
- 海外事例（最低2カ国）
- 技術構成
- 運用モデル
- コスト構造
- 成功事例と失敗事例
# 2. 構造設計
README.mdにドキュメント一覧を作成すること。
# 3. 出力構成
以下の構成で出力すること：
- README.md
- docs/ 配下に各ドキュメント
# 4. 役割分担
以下の役割でサブエージェントとして分担すること：
- Research Agent：情報収集
- Architect Agent：構造設計
- Business Agent：ビジネス整理
- Engineer Agent：技術設計
- Reviewer Agent：レビュー
# 5. 品質基準
各ドキュメントに以下を含めること：
- 想定読者
- 前提条件
- 用語定義
- 図解
- 比較（メリット・デメリット）
- リスク・課題
# 6. 読者定義
以下の読者を対象とすること：
- 経営層
- 選定する技術者
- 実装する技術者
# 7. レビュー
以下の観点でレビューすること：
- 網羅性
- 実現可能性
- コスト妥当性
- 技術難易度
- 運用負荷
- リスク
# 8. 改善
レビュー結果をもとに：
- 不足ドキュメントの追加
- 修正の実施
# 9. ループ制御
最大3回のレビューサイクルで完了とする。
# 10. 完了条件
以下を満たした場合に完了とする：
- READMEに定義された全ドキュメントが存在
- レビュー指摘が解消済み
- 追加ドキュメントが不要と判断
# 出力形式
Markdown形式とし、README.mdおよびdocs構成で整理すること。
まとめ
AIエージェントはプロセスが与えられないと安定した成果を出せません。
適切な設計を行えば、継続的に成果物を生成する実行主体として機能します。
さいごに
かんたんでしたね