mcpField
H
harness-genome

harness-genome

github.com/ruvnetAgent 工作流80.0k236 次安装今天更新
代码仓库

关于 harness-genome

harness-genome 是用于评估仓库的技能，生成分类与数值报告，涵盖仓库类型、Agent 拓扑建议、风险、MCP 范围、测试置信度和发布准备度。它适用于仓库审查和 CI 检查，支持 JSON 或 Markdown 输出及可选风险阈值。

主要功能

  1. 01报告仓库类型和 Agent 拓扑
  2. 02评估风险、测试置信度及发布准备度
  3. 03描述 MCP 范围
  4. 04保留上游判定和退出码
  5. 05支持风险阈值告警及 Markdown 输出

适用场景

  1. 01在搭建 harness 前评估仓库
  2. 02跟踪 Agent 拓扑建议的变化
  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 是一份包含 7 个部分的分类／数值报告，涵盖仓库类型、Agent 拓扑建议、风险评分（0-1）、MCP 覆盖范围、测试置信度（0-1）和发布就绪度（0-1）。

算法

实现：scripts/genome.mjs。

  1. 调用 npx metaharness genome <path> --json（硬超时为 60s）。
  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 服务托管在远程，而非随项目打包。

适用场景

  • 预创建审查：“在基于此仓库搭建自定义 harness 之前，我们应该这样做吗？”——genome 会给出明确的分类结论。
  • 漂移检测：随时间记录 genome 快照，通过类似 cost-diff 的工具进行比较，以发现 agent_topology 建议何时偏离既定的架构选择。
  • CI 门禁：--alert-on-risk-above 0.5 会在仓库的风险状况超过阈值时令构建失败。

配套工具

  • harness-score — 数值化就绪度
  • harness-mcp-scan — MCP 静态安全检查结果
  • harness-threat-model — 企业审查级别的威胁模型

评论

支持 Markdown