mcpField
M
mb-harness

mb-harness

github.com/mrvladd-dエージェントワークフロー5640 回インストール21 週間前に更新
リポジトリ

mb-harness について

mb-harnessは、エージェント向けのリポジトリ実行ガイドと品質ゲートを整えるスキルです。標準コマンドと並列worktreeの手順を文書化し、Codex設定やMemory Bankチェックも任意で追加します。

主な機能

  1. 01ビルド・テスト・lintコマンドの文書化
  2. 02エージェントの入口と品質ゲートの定義
  3. 03並列worktree運用手順の整備
  4. 04Memory Bank lintと準備状況チェックの追加
  5. 05Codexプロファイルの任意設定

活用シーン

  1. 01自律エージェント作業に向けたリポジトリ準備
  2. 02ビルドとテスト手順の明確化
  3. 03worktreeを使った並列エージェントの調整

インストール

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

$npx skills add https://github.com/mrvladd-d/memobank --skill mb-harness

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

同梱ファイルassets/codex-config.toml

詳細

mb-harness — ハーネスエンジニアリングのセットアップ

  • 概要： コマンド、ゲート、並列実行に安全なワークフローなど、リポジトリを取り巻く実行ハーネスを定義します。
  • 使用する場面： 自律的な作業や複数セッションでの作業を始める前に、リポジトリのエージェント向けガードレールを強化する必要がある場合。
  • 入力： リポジトリのルート、およびプロジェクトの標準的なビルド、テスト、lint コマンド。
  • 出力： 品質ゲートの文書、オプションの Codex 設定、エージェント実行のためのより安全なハーネス。

目標

リポジトリを、エージェントが確実に使える「ハーネス」にします。

  • 明確なエントリーポイント（AGENTS.md）
  • 再現可能なコマンド（ビルド／テスト／lint）
  • 機械的なチェック（CI + MB lint）
  • 並列実行に安全なワークフロー（worktree）

プロセス

1) Codex プロジェクト設定（任意ですが推奨）

Codex を使用する場合：

  1. .codex/ フォルダーを作成します。
  2. assets/codex-config.toml をもとに .codex/config.toml を作成します。

使用例：

  • デフォルトのプロファイル（コーディング）：codex
  • 詳細レビュー：codex --profile deep-review
2) 品質ゲートを文書化する

AGENTS.md には、標準的なコマンドを簡潔に記載します（例）：

  • 依存関係のインストール
  • lint／型チェック
  • 単体テスト
  • E2E テスト

リポジトリに UI またはブラウザーのフローがある場合は、次の項目を明記します。

  • Playwright のコマンド
  • agent-browser／browser MCP のパス（利用可能な場合）
  • スクリーンショット／動画／トレースの保存場所
  • リリース上重要と見なされるフロー

存在しない場合は、最小限のスクリプトや Make ターゲットを追加します。

3) Worktree ワークフロー（並列エージェント）

複数のエージェントが並列で作業する場合：

  • ファイルの競合を避けるため、エージェントごとに worktree を作成します
  • ゲートを通過してからマージします

例：

git worktree add ../wt-agent-1 -b agent-1
4) 決定論的な Memory Bank ゲートを追加する

まだ導入されていない場合は、パッケージに含まれる Memory Bank ゲートのアセットをインストールします。

  • mb-garden/assets/mb-lint.mjs を scripts/mb-lint.mjs に配置
  • mb-garden/assets/mb-doctor.mjs を scripts/mb-doctor.mjs に配置
  • デフォルトのヘルスゲートを CI ワークフローでカバー

mb-garden/assets は現在のパッケージ済みアセットの場所であり、doctor の役割が概念上そこに属するという意味ではありません。mb-lint は構造上および機械的な健全性を確認します。mb-doctor は mb-lint のチェックに加えて、ワークフロー／自律実行の準備状況を確認します。通常のキュー投入前のヘルスチェックでは、デフォルトの mb-doctor を実行します。厳格モードは JSON タスクキューが存在してからのみ実行します。つまり、/prd-to-tasks の後、/autonomous 内でスケジューラーを実行する前、またはキューがすでに準備されている場合は /autopilot の前に実行します。

node scripts/mb-lint.mjs
node scripts/mb-doctor.mjs --strict

ハーネスでは、task.tier が欠落している場合、ブロッキングポリシーエラーとして扱う必要があります。タスク状態は .memory-bank/tasks/index.json とインデックス化された TASK-*.task.json レコードのみで管理します。backlog.md、Markdown のタスクカード、以前の risk／risk.level によるルーティングはサポートされていません。

4.1) UI プロジェクトのブラウザー検証

製品に UI がある場合：

  • 「手動で見て問題なさそう」とするより、Playwright／agent-browser／CDP 駆動のチェックを優先します
  • アーティファクト（スクリーンショット、動画、トレース）を .tasks/TASK-XXX/ に保存します
  • 標準的なブラウザー検証コマンドを .memory-bank/testing/index.md に記載します
5) 任意：スキル評価ハーネス

スキルを頻繁に改良する場合：

  • codex exec --json の実行と決定論的な評価器を使用します（OpenAI の評価ガイダンスを参照）

完了の定義

  • Codex を使用する場合、コーディング用とレビュー用のプロファイルを含む .codex/config.toml が存在する。
  • AGENTS.md に品質ゲートのコマンドが記載されている。
  • リポジトリに worktree の使用方法が文書化されている。
  • Memory Bank lint が存在し、合格する。
  • UI のあるリポジトリに、ブラウザー駆動の検証方法が文書化されている。

コメント

Markdown 対応