engineer-agentic-ai

🛠️ エージェント型 AI のエンジニアリング

エージェントに望む振る舞いを、対象ランタイムが観測、トリガー、実行、永続化、検証できる仕組みに変換します。

🗂️ 目次

• 🎯 目的と適用範囲
• 🧭 エンジニアリングフレームワーク
• 📚 リファレンスの選択
• ✅ 品質ゲート

🎯 目的と適用範囲

エージェントが何を理解、判断、記憶、トリガー、防止、達成すべきかは示されているものの、具体的なランタイムの仕組みが欠けている、または不明確な場合に、このスキルを使用します。対象には、指示、スキル、ルーティング、ツール、MCP サーバー、フック、権限、プラグイン、自動化、永続化、委任、および関連するエージェントシステムの振る舞いが含まれます。

成果は、実装され、振る舞いを検証済みの仕組み、またはランタイムの一連の処理をまだ完結できない場合に、明示的に保持された問題空間の要件です。

🧭 エンジニアリングフレームワーク

一貫したエンドツーエンドのプロセスとして、次の手順を使用します。

1. 問題空間における意図を維持します。 早まってプロンプトの文面やプロバイダー機能に置き換えず、観測可能な成果を明確にします。
2. 調査の対象を絞ります。 リファレンスの選択を使用し、現在の不確実性を解消するために必要な、最小範囲のリファレンスだけを読み込みます。
3. 振る舞いを運用可能な形にします。 観測可能なシグナルと証拠 → トリガー／ライフサイクルイベント → 判断ルール → 作動手段 → 永続化 → 検証をつなぎます。信頼性と見逃した場合のコストに関する要件も含めます。必要なリンクが利用できない場合は、実装済みとみなさず、成果を問題空間に残します。
4. 仕組みと適用箇所を選択します。 求められる信頼性を満たせる、利用可能な最も軽量な仕組みを選びます。選択がプロバイダーの機能に左右される場合は、現在の機能を確認します。
5. 標準の適用箇所に実装します。 権威ある指示、スキル、フック、ツール、権限、プラグイン、スクリプト、自動化、または設定を変更し、変更の反映経路を検証します。
6. 実際の振る舞いを検証します。 代表的なエージェントとのやり取り、またはランタイムイベントを通じて仕組みを実行します。構文、ファイルの存在、もっともらしい説明だけでなく、観測可能な成果をテストします。
7. 診断して反復します。 失敗した場合は、ガイダンスの鮮度、トリガーの一致、可視の証拠、ルールの仕様、ルーティング／選択、作動、権限、永続化、反映を順にたどります。仕組みまたはテストを調整して、再度実行します。振る舞いがモデルに左右される、またはルーティングに依存する場合は、肯定、否定、境界、反復の各ケースを使用します。
8. 昇格して引き継ぎます。 必要な振る舞いの証拠が揃ってから昇格します。デプロイ済み／生成済みのコピーを更新し、残る不明点とテスト済みの範囲を記録し、置き換えられたウィッシュリスト項目は削除するか、廃止済みと明記します。

詳細な運用化、検証、デバッグ、昇格の方法は、エージェントエンジニアリングプロセスに記載されています。このファイルに同様の手順を重複して作成しないでください。

📚 リファレンスの振り分け

現在の判断または障害の条件に合致する場合にのみ、リファレンスを読み込みます。

条件	読むもの	用途
エージェントの動作の翻訳、検証、デバッグ、または本番化を行う場合	エージェントエンジニアリングプロセス	運用への落とし込み、メカニズムの選択、動作テスト、障害の診断、ウィッシュリスト項目の本番化。
コンテキスト、ツール、フック、状態、セッション、コンパクション、または委任の動作を明確にする場合	エージェントのランタイムモデル	ランタイムの仕組みと、Codex 固有のライフサイクルに関する根拠。
選択、メタデータ、インターフェース境界、または強制機能の欠如を診断する場合	インターフェース、ルーティング、制御の設計	選択前のルーティングと、選択後の実行および制御の強度。
音声／テキスト、デスクトップ／ウェブ、承認、バックグラウンド作業、または結果の配信について検討する場合	インタラクションのランタイムモデル	人間からランタイムへの入力、ライフサイクル、結果の返却経路の動作。
ID、マシン、オペレーティングシステム、またはプロバイダーをまたいで再利用可能な成果物を設計する場合	移植性とプロバイダーのマッピング	概念を優先した移植性と、プロバイダーに依存しない表現。
プロバイダー固有の正確なファイル名、ディレクトリ、マニフェスト、または設定場所が必要な場合	プロバイダーのパスリファレンス	現在のプロバイダー固有のパスの対応付けと情報源。
コンテキストサイズ、トークン、キャッシュ、コンパクションのコスト、利用枠、クレジット、または請求を分析する場合	トークン使用量とコストモデル	使用量の根拠、キャッシュの仕組み、製品の利用量計算、最適化。

✅ 品質ゲート

次の条件を満たした場合にのみ、変更を完了とします。

• 運用化の連鎖が完了しているか、未完了のリンクが未解決の要件として明示的に残されている。
• 選択したメカニズムと振り分け先のリファレンスによって、競合する標準ルールを設けることなく、必要な信頼性が確保されている。
• 動作検証によって、指定された対象環境と範囲で意図した結果が得られることが証明されている。
• 標準ソース、伝播経路、デプロイ済み／生成済みの状態が検証されている。
• 引き継ぎ時に未解決の不明点が明示され、該当するウィッシュリストから本番環境へのライフサイクルが完了している。