Repo-lab
開発ツール

Better Harness：Claude Code・Cursor対応のAIコーディングエージェント改善ツール

⭐ 1,307 stars GitHub →

Better Harness：Claude Code・Cursor対応のAIコーディングエージェント改善ツール

Better Harnessは、Claude Code・Codex・Cursor・GitHub Copilot・Qwen Codeなど主要AIコーディングエージェントのワークフローを分析し、根拠に基づいた改善提案を生成するオープンソースツールです。Alibaba傘下のQoderチームが開発・MITライセンスで公開しており、プロジェクトと各AIエージェントセッションのエビデンスを分析してエージェント活用の弱点を可視化します。

GitHubで急上昇中の better-harness をご紹介します。 スター数 1,307★ を獲得し、DevTool分野で注目されているツールです。

Better Harness とは？

Better Harnessは、AIコーディングエージェントの「ハーネス（エージェントを取り巻く環境）」を分析・改善するためのオープンソースフレームワークです。Alibaba傘下のQoderチームが開発し、MIT Licenseで公開されています。

「ハーネスエンジニアリング」とはエージェントが正しく動くための環境設計を指します。エージェントが正確にタスクの目標を把握し、触れてはいけない領域を知り、結果の正誤を判定し、失敗時の対処法を持てるか——この「Agent Work Loop」の質を測り改善するのがBetter Harnessの役割です。

Qoderチームは「自分たちのリポジトリで使ったら100点満点中58点だった（2軸で50点以下）」と公開しており、どんな成熟したプロジェクトでも改善余地があることを示しています。現在16名のコントリビューターが参画し、Claude Code・Codex・Cursor・GitHub Copilot・Qwen Codeなど主要エージェントをサポートしています。

こんな人におすすめ:

  • エンジニア向け: AIコーディングエージェントを業務で使うフルスタックエンジニア・MLエンジニアが、エージェント活用の弱点を客観スコアで把握し改善できます
  • 非エンジニア向け: プログラミング知識が必要なため、エンジニア専用ツールです

主な機能・特徴

  • 主要AIコーディングエージェント対応: Claude Code・Codex・Cursor・GitHub Copilot・Qwen Code・Qoder CLI・Piで動作
  • エビデンスベースの分析: セッション記録・プロジェクト設定・ワークスペース情報を読み込み、根拠のある改善提案を生成
  • HTML＋Markdownレポート出力: スコア・優先度付き改善タスク・実行可能なネクストステップを含む自己完結型レポートを生成
  • スキル・モデル・フック拡張可能: skills/・models/・hooks/ディレクトリを通じてカスタム評価軸の追加が可能
  • 欠損エビデンスの明示: 分析できなかった領域は「エビデンスなし」として明示し、サイレントな見落としを防止

使い方・始め方

Claude Code での導入（最も簡単な方法）

# プロジェクトディレクトリで実行
claude code --plugin-marketplace-add QoderAI/better-harness
claude code --plugin-install better-harness@better-harness

新しいセッションを開始してから以下のプロンプトを実行します：

/better-harness analyze this project's AI coding workflow and generate an evidence-backed report

Codex Desktop での導入

codex plugin marketplace add QoderAI/better-harness
codex plugin install better-harness@better-harness

Cursor での導入（現在マーケットプレイス未公開）

git clone https://github.com/QoderAI/better-harness.git
cursor-agent --plugin-dir /path/to/better-harness

GitHub Copilot での導入

copilot plugin marketplace add QoderAI/better-harness
copilot plugin install better-harness@better-harness

ソースからビルド・開発する場合

git clone https://github.com/QoderAI/better-harness.git
cd better-harness
npm ci
npm test
npm run pack:verify

活用事例

フルスタックエンジニアによるClaude Code活用最適化

Claude Codeを使って大規模リファクタリングを進めているフルスタックエンジニアが、/better-harnessを実行することで「エージェントがタスク境界を正しく認識しているか」「CLAUDE.mdの設定が有効に機能しているか」「セッション間での一貫性が保たれているか」を客観的スコアで確認できます。スコアが低い軸については優先度付きの改善タスクが自動生成され、次のアクションが明確になります。

MLエンジニアによるCodexワークフロー改善

機械学習パイプラインの開発にCodexを活用するMLエンジニアが、better-harnessを定期的に実行することでエージェントワークフローの品質を継続的にモニタリングできます。case-studies/ディレクトリには他チームの活用事例が掲載されており、同じ課題を持つチームの解決策を参考にできます。

類似ツールとの違い・なぜ今このツールか

エージェント評価ツールとの比較

AIコーディングエージェントの改善アプローチとして、CLAUDE.mdの手動整備やシステムプロンプトの試行錯誤が一般的でした。Better Harnessはこれを構造化します：

比較観点 手動整備 Better Harness
分析の客観性 主観的 エビデンスベースのスコアリング
対応エージェント 個別対応 6種類のホスト対応（統一コマンド）
欠損の可視化 見落としが発生 欠損エビデンスを明示
改善の優先付け 手動判断 優先度付きタスクとして自動生成

2026年にAIコーディングエージェント（Claude Code・Cursor等）が普及する中、「モデル選択」より「エージェント環境設計」が成果を左右するという知見が広まっています。Better Harnessはその「ハーネスエンジニアリング」を実践するための初めての本格的OSSツールとして注目されています。

こんな人に向いている

AIコーディングエージェントを業務導入したシニアエンジニア

Claude CodeやCursorを本格的に業務へ導入し、「思ったより精度が出ない」「エージェントがコンテキストを正しく理解していない」と感じているシニアエンジニアに最適です。自分のプロジェクト設定の何が弱点かを数値で把握し、具体的な改善ステップを得られます。

プラットフォームエンジニア・DevOpsエンジニア

チーム全体のAIコーディング環境を整備するプラットフォームエンジニアが、hooks/やskills/を拡張することで組織固有の評価基準を追加できます。CIパイプラインへの組み込みも検討でき、エージェントワークフローの品質ゲートとして活用できます。

フロントエンドエンジニア・フルスタックエンジニア

GitHub Copilot・Cursor・Codexを日常的に使うフロントエンドエンジニアが、better-harnessのレポートを確認することで使っているエージェントの「限界」と「伸びしろ」を把握できます。特に複数エージェントを比較しながら最適な組み合わせを探したい場合に有用です。

使う前に知っておきたいこと

エビデンス取得範囲の限界

エージェントごとにセッション記録の保存方式が異なるため、エビデンス収集の範囲に差があります。例えばVS Code版Copilot Chatは永続的なトランスクリプトを保存しないため、セッション分析ができない場合があります。Cursor向けはマーケットプレイス公開前の手動インストールが必要です。

開発状況

正式リリース（タグ付きRelease）はまだ行われていません。GitHubのIssueにSESSION_POPULATION_BINDING_MISMATCHなどのバグ報告があり、Claude Code環境によっては動作しない場合もあります。本番環境への適用前に開発環境でのテストを推奨します。

ライセンスとプロジェクトの背景

MIT Licenseを採用しています。商用利用・改変・再配布はいずれも許可されています。開発元はAlibaba傘下のQoderチームですが、ツール自体はオープンソースで特定クラウドサービスへの依存はありません。

関連ツール・おすすめサービス

  • DigitalOcean — 開発者向けクラウド。Better Harnessの分析環境やCI/CDパイプライン構築に最適なApp Platformを提供

まとめ

Better Harnessは、AIコーディングエージェントの「ハーネス（環境設計）」を客観的に分析し、根拠ある改善提案を生成するオープンソースツールです。Claude Code・Cursor・GitHub Copilot・Qwen Codeなど主要エージェントに対応しており、/better-harnessコマンド一発でプロジェクトのエージェントワークフロー品質スコアを確認できます。AIコーディングエージェントを本格活用するエンジニアにとって、「モデルを変える」前に「環境を整える」ための視点を与えてくれる貴重なツールです。

GitHub でチェックする →

この技術を学ぶ

DevToolに興味を持った方には、Udemyのオンラインコースもおすすめです。

毎日更新のGitHubツール情報

LINEで受け取って最新情報をキャッチアップしよう

友達追加する（無料）

関連記事

この記事が役に立ったらシェアしてください