mcpField
H
harness-genome

harness-genome

github.com/ruvnetエージェントワークフロー80.0k236 回インストール今日更新
リポジトリ

harness-genome について

harness-genomeは、リポジトリ種別、エージェント構成の推奨、リスク、MCPの範囲、テスト信頼度、公開準備度を分類値と数値で示す評価スキルです。リポジトリのレビューやCIチェック向けで、JSONまたはMarkdown出力と任意のリスク閾値に対応します。

主な機能

  1. 01リポジトリ種別とエージェント構成の報告
  2. 02リスク、テスト信頼度、公開準備度の評価
  3. 03MCP範囲の記述
  4. 04上流の判定と終了コードの保持
  5. 05リスク閾値アラートとMarkdown出力

活用シーン

  1. 01ハーネス構築前のリポジトリ評価
  2. 02エージェント構成の推奨変化の追跡
  3. 03設定した閾値超過時のCI失敗

MCP 対応

レポートにMCP範囲の項目を含みます。MCPツールの公開やMCPサーバーの管理については記載されていません。

インストール

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

$npx skills add https://github.com/ruvnet/ruflo --skill harness-genome

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

詳細

harness-score の補完ツールです。score が 5 次元の数値スコアカードであるのに対し、genome はリポジトリの種類、エージェントトポロジーの推奨事項、リスクスコア（0～1）、MCP の対象範囲、テストの信頼度（0～1）、公開準備度（0～1）を含む、7 セクションのカテゴリ別／数値レポートです。

アルゴリズム

実装：scripts/genome.mjs。

  1. npx metaharness genome <path> --json をシェルから実行します（タイムアウトは 60 秒）。
  2. 次の形式を解析します：{ repo_type, agent_topology[], risk_score, mcp_surface, test_confidence, publish_readiness }。
  3. 上流の準備状況の判定を verdict と verdictExitCode として保持します。上流は needs-work の場合に 1、blocked の場合に 2 で終了しますが、これらは有効なレポートであるため、ラッパーは正常に返します。
  4. --alert-on-risk-above N を指定した場合、risk_score > N のときに 1 で終了します。
  5. JSON（デフォルト）または Markdown を出力します。

フェーズ 0 のベースライン（ruflo、2026-06-16 に測定）

{
  "repo_type": "node_mcp_ci",
  "agent_topology": ["maintainer", "tester", "security", "release"],
  "risk_score": 0.27,
  "mcp_surface": "remote",
  "test_confidence": 0.8,
  "publish_readiness": 0.9
}

Ruflo の risk_score: 0.27 は低く（良好です）、publish_readiness: 0.9 は高い値です。mcp_surface: "remote" は、ruflo の MCP サーバーがバンドルされているのではなく、ホストされていることを示しています。

使用する場面

  • ミント前のレビュー：「このリポジトリからカスタムハーネスをスキャフォールディングする前に、そうすべきか？」という問いに、genome がカテゴリ別に答えます。
  • ドリフト検出：genome のスナップショットを定期的に取得し、コスト差分のようなツールで比較して、agent_topology の推奨事項が意図的に選択したアーキテクチャから逸脱していないかを確認します。
  • CI ゲート：--alert-on-risk-above 0.5 を指定すると、リポジトリのリスクプロファイルがしきい値を超えたときにビルドが失敗します。

組み合わせて使うツール

  • harness-score — 数値による準備状況
  • harness-mcp-scan — 静的な MCP セキュリティ検出結果
  • harness-threat-model — エンタープライズレビューに対応した脅威モデル

コメント

Markdown 対応