mcpField
H
harness-creator

harness-creator

github.com/walkinglabsエージェントワークフロー22.1k2.4k 回インストール6 日前に更新
リポジトリ

harness-creator について

Harness Creator は、コーディングエージェントが適切に作業を始め、範囲を守り、成果を検証し、セッションをまたいで作業を再開できるよう支援するスキルです。指示、状態、検証、範囲、ライフサイクルからなる軽量なハーネスの作成と監査を案内します。

主な機能

  1. 01軽量なエージェントハーネスの作成
  2. 02既存ハーネスの監査
  3. 035 つのサブシステムの評価
  4. 04構造評価レポートの生成
  5. 05完了判定前の証拠確認

活用シーン

  1. 01リポジトリへのエージェント指示の追加
  2. 02プロジェクトの検証手順の確認
  3. 03セッションをまたぐ作業の再開
  4. 04ハーネスの構造評価レポートの作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/walkinglabs/learn-harness-engineering --skill harness-creator

インストール後、Claude Code で/harness-creatorを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

metadata.json
README-UK.md
README.md
SKILL.md.en
SKILL.md.uk
agents/
openai.yaml
evals/
evals.json
references/
context-engineering-pattern.md
gotchas.md
lifecycle-bootstrap-pattern.md
memory-persistence-pattern.md
multi-agent-pattern.md
skill-runtime-pattern.md
tool-registry-pattern.md
scripts/
create-harness.mjs
render-assessment-html.mjs
run-benchmark.mjs
validate-harness.mjs
scripts/lib/
harness-utils.mjs
templates/
agents.md
feature-list.json
feature-list.schema.json
init.sh
progress.md
session-handoff.md

詳細

Harness Creator

このスキルは、コーディングエージェントがリポジトリで作業を始めやすくし、作業範囲を守り、成果を検証し、セッションをまたいで作業を再開しやすくするために使用します。エージェントが実際に従う程度に、ハーネスは小さく保ちます。

モデルの選定、プロンプトの単独での調整、チャット UI の設計、一般的なアプリケーションアーキテクチャには使用しません。

基本モデル

有用なコーディングエージェント用ハーネスは、次の 5 つのサブシステムで構成されます。

サブシステム最小限の成果物目的
指示AGENTS.md または CLAUDE.md起動手順、作業ルール、完了の定義
状態feature_list.json、progress.md現在の機能、ステータス、根拠、次のステップ
検証init.sh または文書化されたコマンド完了を宣言する前にエージェントが実行するテスト／チェック
範囲機能の依存関係と完了基準範囲の逸脱や未完了の作業を防止
ライフサイクルsession-handoff.md、セッション終了時の手順次のセッションから作業を再開できるようにする

最初に行うこと

  1. 既存のものを確認します。指示ファイル、機能／状態ファイル、検証コマンド、ドキュメント、パッケージマニフェストを調べます。
  2. 安全に推測できない情報が不足している場合に限り、質問します。対象エージェント、希望するファイル名、構成に対する許容度、上書きが許可されているかどうかを確認します。
  3. まずは最小限のハーネスを優先します。ユーザーの課題に必要な場合に限り、メモリ、ツールの安全性、マルチエージェント、ベンチマークの詳細を追加します。

よくあるタスク

ハーネスを作成する

ローカルリポジトリで作業する場合は、同梱のスクリプトを使用します。

node skills/harness-creator/scripts/create-harness.mjs --target /path/to/project

オプション：

  • Claude 向けのプロジェクトには --agent-file CLAUDE.md を指定します。
  • 検出結果が誤っている場合は --package-manager npm|pnpm|yarn|bun を指定します。
  • 独自の検証コマンドには --commands "cmd one,cmd two" を指定します。
  • --force は、上書きが許可されていることを確認してから使用します。

作成されたものと、プレースホルダーの機能項目をどのように置き換えるかをユーザーに説明します。

既存のハーネスを監査する

次を実行します。

node skills/harness-creator/scripts/validate-harness.mjs --target /path/to/project

5 つのサブシステムのスコア、最もスコアが低い領域、信頼性を高める最初の 2～3 件の変更を報告します。最も低いスコアの領域はボトルネック候補として扱い、因果関係を断定する前に、失敗、ログ、またはタスクの結果で確認します。

レポートを作成する

共有可能な評価をユーザーが求めている場合に使用します。

node skills/harness-creator/scripts/render-assessment-html.mjs --target /path/to/project
node skills/harness-creator/scripts/run-benchmark.mjs --target /path/to/project --html /path/to/report.html

これは構造的なベンチマークであることを明確にします。ベンチマークでは、まず使い捨てのハーネスを構築して検証するセルフチェックを実行し、同梱スクリプトがエンドツーエンドで動作することを確認してから、対象と評価範囲をスコアリングします。実際の有効性を評価するには、代表的なタスクでエージェントのセッションを実施し、前後を比較する必要があります。

参照資料を読むタイミング

ユーザーの課題に必要な参照資料のみを読み込みます。

設計ルール

  • ルートの指示ファイルは短く保ちます。完全なマニュアルではなく、振り分け方法と不変条件を記載します。
  • プロジェクト固有の情報は、スキルではなくプロジェクトのドキュメントに記載します。
  • 検証コマンドは明確にし、実行可能な形で記載します。
  • 機能を完了としてマークする前に、根拠を求めます。
  • ハーネスで明示的なマルチエージェントの所有権境界を設けている場合を除き、アクティブな機能は 1 つにします。
  • チャット履歴に頼らず、状態ファイルに追記または更新することを優先します。
  • スクリプトに破壊的な動作を隠してはいけません。上書きにはユーザーの明示的な承認が必要です。

成果物チェックリスト

使用可能な最小限のハーネスを用意するには、対象プロジェクトに次のものを残します。

  • AGENTS.md または CLAUDE.md
  • feature_list.json
  • progress.md
  • init.sh
  • 複数セッションで作業する場合は、任意で session-handoff.md
  • 検証結果の記録または次のアクション

ファイルを作成できない場合は、ファイルの内容とコマンドを正確に提示してください。

コメント

Markdown 対応