Agent の作業を支えるエンジニアリング環境を確認し、改善計画につなげます。
Better Harness は、1 回のタスクの回答ではなく、Agent が作業するための環境全体を確認します。タスクの理解、実行、検証、納品を繰り返し妨げる弱点を見つけ、再利用する価値のある知見を保守可能なプロジェクト資産にするために役立ちます。
Agent は通常、「タスクを理解する → 操作する → 結果を確認する → 調整する」というループで作業します。このループを安定させるには、モデルの能力だけでなく、明確なプロジェクトコンテキスト、利用可能なツール、操作上の境界、信頼できる検証方法、過去のタスクから得た知見を保持する仕組みが必要です。
Agent の作業を支えるこれらの仕組みをまとめて Agent Harness と呼びます。プロジェクトに応じて、リポジトリの指示、Rules、Skills、Hooks、Plugins、Connectors、スクリプト、テストコマンド、リリースチェック、人によるレビューなどが含まれます。Harness は、Agent が次の実務的な問いに答えられるようにします。
Harness の不足は、1 回の成功したタスクだけでは気付きにくいものです。同じ指示を何度も伝える、プロジェクト規約が文書化されない、検証手順が抜ける、レビューで得た知見が次のタスクに反映されない、といった形で徐々に現れます。Better Harness はこのような繰り返しのパターンを整理し、再発を防ぐための最小で持続的な改善を見つけます。
Better Harness は、次のループで改善を進めます。
各 finding について、問題の根拠、影響する工程、Rule・Skill・Hook・スクリプト・人による承認などの恒久対策、後続タスクでの検証方法を確認します。提案を修復に移す前に、リポジトリとチームの運用に照らして妥当性を判断してください。
Agent Harness とは
Agent は通常、「タスクを理解する → 操作する → 結果を確認する → 調整する」というループで作業します。このループを安定させるには、モデルの能力だけでなく、明確なプロジェクトコンテキスト、利用可能なツール、操作上の境界、信頼できる検証方法、過去のタスクから得た知見を保持する仕組みが必要です。
Agent の作業を支えるこれらの仕組みをまとめて Agent Harness と呼びます。プロジェクトに応じて、リポジトリの指示、Rules、Skills、Hooks、Plugins、Connectors、スクリプト、テストコマンド、リリースチェック、人によるレビューなどが含まれます。Harness は、Agent が次の実務的な問いに答えられるようにします。
- 期待される結果は何か。今回の範囲外はどこか。
- このプロジェクトをどのように実行し、変更すべきか。
- 結果が正しいことを、どのエビデンスで証明するか。
- 操作や検証に失敗した場合、次に何をすべきか。
Better Harness を使う理由
Harness の不足は、1 回の成功したタスクだけでは気付きにくいものです。同じ指示を何度も伝える、プロジェクト規約が文書化されない、検証手順が抜ける、レビューで得た知見が次のタスクに反映されない、といった形で徐々に現れます。Better Harness はこのような繰り返しのパターンを整理し、再発を防ぐための最小で持続的な改善を見つけます。
確認する内容
- タスクの目的、範囲、プロジェクトコンテキスト
- Rules、Skills、Hooks、Plugins、Connectors などの再利用可能な Agent 資産
- 実行の入口、制御方法、繰り返し発生する手作業
- 検証エビデンス、納品手順、タスク結果
- 長期的なルール、ワークフロー、ツールにすべきプロジェクトのフィードバック
レビューから改善まで
Better Harness は、次のループで改善を進めます。
- 現在の Harness を整理する：タスクのコンテキスト、実行経路、再利用可能な資産、検証手順、納品プロセス、既存のフィードバックを確認します。
- 中断点を見つける：明確な指示、実際の連携、実行エビデンス、失敗時の復旧方法が不足している箇所を特定します。
- 最小で持続的な修復方法を選ぶ：問題に応じて Rule、Skill、Hook、スクリプト、ワークフロー、人によるレビューを選択します。
- 改善を検証する：レビュー可能な独立タスクで変更し、関連チェックを実行して、後続の代表的なタスクで新しい仕組みが実際に使われることを確認します。
レビューを開始する
- 確認したいワークスペースでタスクを開きます。
- 入力欄に
/better-harnessと入力します。 - スラッシュコマンド候補から better-harness:better-harness を選択します。
- 繰り返すリリースミス、テスト証跡の不足、Agent が見落とすプロジェクト規約など、重点を追加します。
- タスクを送信し、現在のプロジェクトと関連するタスク履歴を確認させます。
結果を確認する
各 finding について、問題の根拠、影響する工程、Rule・Skill・Hook・スクリプト・人による承認などの恒久対策、後続タスクでの検証方法を確認します。提案を修復に移す前に、リポジトリとチームの運用に照らして妥当性を判断してください。
安全に改善する
- 受け入れ条件が明確で価値の高い finding を 1 つ選びます。
- 独立したタスクで修復し、ファイル変更とツール操作をレビューできる状態にします。
- 計画に記載されたプロジェクト固有のチェックを実行します。
- Better Harness または代表的なタスクを再実行し、新しい仕組みが実際に使われることを確認します。