mcpField
H
harness-engineering-playbook

harness-engineering-playbook

github.com/broomvaエージェントワークフロー26384 回インストール18 週間前に更新
リポジトリ

harness-engineering-playbook について

エージェント中心のワークフローを構築または再編するチーム向けの、skills.sh互換スキルです。リポジトリ用テンプレート、決定的なコマンド、監査を通じて、Harness Engineeringの実践を適用します。

主な機能

  1. 01リポジトリ向けHarness文書と設定の生成
  2. 02smoke、check、ciコマンドのラップ
  3. 03モジュール境界とデータ契約の設定
  4. 04構造化された可観測性の追加
  5. 05文書のずれと不安定なスクリプトの監査

活用シーン

  1. 01既存リポジトリへのエージェントワークフロー導入
  2. 02自律実行のチェック手順の統一
  3. 03Harness設定の監査と改善

インストール

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

$npx skills add https://github.com/broomva/harness-engineering --skill harness-engineering-playbook

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

同梱ファイル

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

README.md
.skills/harness-engineering-playbook/agents/
openai.yaml
.skills/harness-engineering-playbook/assets/templates/
Makefile.harness
PLANS.md
AGENTS.md
.skills/harness-engineering-playbook/assets/templates/.github/workflows/
harness.yml
nightly-harness-audit.yml
.skills/harness-engineering-playbook/assets/templates/docs/
OBSERVABILITY.md
ARCHITECTURE.md
.skills/harness-engineering-playbook/assets/templates/docs/control/
ACTUATORS.md
CONTROL_SYSTEM.md
ENTROPY.md
CONTROLLER.md
FEEDBACK_LOOP.md
SETPOINTS.md
SENSORS.md
STABILITY.md
.skills/harness-engineering-playbook/assets/templates/evals/
control-loop-metrics.yaml
.skills/harness-engineering-playbook/assets/templates/scripts/
audit_harness.sh
.skills/harness-engineering-playbook/assets/templates/scripts/harness/
entropy_check.sh
lint.sh
smoke.sh
test.sh
typecheck.sh
.skills/harness-engineering-playbook/references/
openai-harness-practices.md
rollout-checklist.md
wizard-cli.md
.skills/harness-engineering-playbook/scripts/
audit_harness.sh
bootstrap_harness.sh
harness_wizard.py

詳細

Harness Engineering Playbook

OpenAI の Harness Engineering ガイドに記載されたプラクティスを実践可能にする、skills.sh 互換のスキルです。これを使ってエージェントファーストのワークフローをセットアップまたはリファクタリングすることで、自律実行を再現可能で、観測可能で、安全なものにできます。

インストール

npx skills add broomva/harness-engineering-skill --skill harness-engineering-playbook

できること

  • ハーネス成果物をブートストラップします: AGENTS.md、PLANS.md、docs/ARCHITECTURE.md、docs/OBSERVABILITY.md、Makefile.harness、および CI ワークフロー。
  • 決定論的なコマンドを make smoke、make check、make ci の背後にラップし、エージェントが確実に実行できるようにします。
  • 厳格なモジュール境界とデータ形状のコントラクトを強制します。
  • 初日から構造化された可観測性（相関 ID、主要な状態遷移）を組み込みます。
  • エントロピー制御の監査と夜間のハーネスチェックを追加し、ドキュメントのドリフトや不安定なスクリプトを防ぎます。

ワークフロー

  1. 対象リポジトリをベースライン化します — 言語、ツールチェーン、既存の CI を検出します。
  2. テンプレートからハーネス成果物をブートストラップします（対話型ウィザードまたはシェルスクリプト）。
  3. リポジトリの成果物全体に 9 つの Harness Engineering プラクティスを適用します。
  4. audit で検証します — MISSING または FAIL があればブロッキングとして扱います。
  5. 実際のエージェント実行の後に反復します — ギャップを修正し、再監査します。

クイックスタート

# Interactive wizard (recommended)
python3 .agents/skills/harness-engineering-playbook/scripts/harness_wizard.py init <repo-path> --profile control

# Shell fallback
./scripts/bootstrap_harness.sh <repo-path>

# Audit
python3 .agents/skills/harness-engineering-playbook/scripts/harness_wizard.py audit <repo-path>

プロファイル

プロファイルスコープ
baselineコアハーネス成果物のみ
controlベースライン + 制御システムのプリミティブ
full制御 + エントロピー制御、夜間監査、CI

出典

OpenAI Harness Engineering ガイド: https://openai.com/index/harness-engineering/

ライセンス

MIT

コメント

Markdown 対応