エージェントハーネス構築 は何をしますか？
このスキルは、エージェントの計画、ツール呼び出し、エラーからの回復、完了への収束を改善する際に使用します。
コアモデル
エージェントの出力品質は以下によって制約されます：
- アクション空間の質
- 観測の質
- 回復の質
- コンテキスト予算の質
アクション空間の設計
- 安定した明示的なツール名を使用します。
- 入力をスキーマファーストかつ狭く保ちます。
- 決定論的な出力形状を返します。
- 分離が不可能でない限り、包括的なツールは避けます。
粒度ルール
- 高リスク操作（デプロイ、マイグレーション、権限）にはマイクロツールを使用します。
- 一般的な編集/読み取り/検索ループにはミディアムツールを使用します。
- ラウンドトリップのオーバーヘッドが支配的なコストとなる場合にのみマクロツールを使用します。
観測設計
すべてのツール応答には以下を含める必要があります：
status: success|warning|errorsummary: 一行の結果next_actions: 実行可能なフォローアップartifacts: ファイルパス / ID
エラー回復契約
すべてのエラーパスに対して、以下を含めます：
- 根本原因のヒント
- 安全なリトライ手順
- 明示的な停止条件
コンテキスト予算管理
- システムプロンプトは最小限かつ不変に保ちます。
- 大規模なガイダンスはオンデマンドでロードされるスキルに移動します。
- 長いドキュメントをインライン化するよりも、ファイルへの参照を優先します。
- 任意のトークンしきい値ではなく、フェーズ境界でコンパクト化します。
アーキテクチャパターンガイダンス
- ReAct: 不確実なパスを持つ探索的タスクに最適。
- 関数呼び出し: 構造化された決定論的フローに最適。
- ハイブリッド（推奨）: ReAct計画 + 型付きツール実行。
ベンチマーキング
以下を追跡します：
- 完了率
- タスクあたりのリトライ数
- pass@1 および pass@3
- 成功タスクあたりのコスト
アンチパターン
- 重複するセマンティクスを持つツールが多すぎる。
- 回復ヒントのない不透明なツール出力。
- 次のステップがないエラー専用の出力。
- 無関係な参照によるコンテキストの過負荷。