エージェントハーネス構築

エージェントの計画立案、ツール呼び出し、エラーからの回復、完了状態への収束の方法を改善する際にこのスキルを使用します。

コアモデル

エージェント出力の品質は以下に制限されます：

1. アクション空間の品質
2. 観測の品質
3. 回復の品質
4. コンテキスト予算の品質

アクション空間設計

1. 安定で明確なツール名を使用する。
2. 入力スキーマを優先し、スコープを狭く保つ。
3. 決定論的な出力形状を返す。
4. 分離できない場合を除き、万能ツールは避ける。

粒度ルール

• リスクの高い操作（デプロイ、マイグレーション、権限）にはマイクロツールを使用する。
• 一般的な編集/読み取り/検索ループにはメディアムツールを使用する。
• ラウンドトリップのオーバーヘッドが主要なコストの場合にのみマクロツールを使用する。

観測設計

各ツール応答には以下を含める必要があります：

• status: success|warning|error
• summary: 1 行の結果
• next_actions: 実行可能な次のステップ
• artifacts: ファイルパス / ID

エラー回復契約

各エラーパスには以下を含める必要があります：

• 根本原因のヒント
• 安全な再試行指示
• 明確な停止条件

コンテキスト予算管理

1. システムプロンプトを最小限で不変に保つ。
2. 大量のガイダンス情報をオンデマンド読み込みスキルに移す。
3. インラインの長いドキュメントではなく、ファイル参照を優先する。
4. 任意のトークン閾値ではなく、フェーズ境界で圧縮する。

アーキテクチャパターンガイダンス

• ReAct：パスが不確定な探索的タスクに最適。
• 関数呼び出し：構造化された決定論的フローに最適。
• ハイブリッドモード（推奨）：ReAct 計画 + 型指定ツール実行。

ベンチマーク

以下を追跡します：

• 完了率
• タスクあたりの再試行回数
• pass@1 および pass@3
• 成功したタスクあたりのコスト

アンチパターン

• セマンティックオーバーラップが多すぎるツール。
• 回復ヒントのない不透明なツール出力。
• 後続ステップなしのエラー出力のみ。
• 無関係な参照を含むコンテキスト過負荷。