mcpField
H
harness-score

harness-score

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

关于 harness-score

harness-score 是 ruflo 技能，可运行 metaharness 评估代码库采用 harness 的准备情况，并输出结构化评分；也可在适配度低于阈值时让 CI 失败。

主要功能

  1. 01评估代码库的 harness 准备度
  2. 02输出 JSON 或 Markdown
  3. 03设置 CI 适配度阈值
  4. 04metaharness 不可用时优雅降级

适用场景

  1. 01推荐配置 harness 前检查代码库
  2. 02适配度低于指定阈值时让 CI 失败

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/harness-score确认已加载。

详细介绍

将上游的 metaharness score CLI 作为 ruflo 技能提供。当 Claude Code 需要评估仓库是否已准备好采用 harness，以便建议用户运行 npx ruflo init 或 harness-mint 时使用。

算法

实现：scripts/score.mjs。

  1. 调用 npx metaharness score <path> --json（单个子进程，硬超时为 60s）。
  2. 解析 JSON 结构：{ harnessFit, compileConfidence, taskCoverage, toolSafety, memoryUsefulness, estCostPerRunUsd, recommendedMode, archetype, template, scaffoldReady, hardConstraints }。
  3. 如果设置了 --alert-on-fit-below N：当 harnessFit < N 时退出码为 1。
  4. 输出 JSON（默认）或 Markdown 表格。

第 0 阶段基线（ruflo 自身的评分卡，测量日期：2026-06-16）

维度值
harnessFit82/100
compileConfidence100
taskCoverage79
toolSafety100
memoryUsefulness40
estCostPerRunUsd$0.048
recommendedModeCLI + MCP
archetypetypescript-sdk-harness
templatevertical:coding
scaffoldReadytrue

Ruflo 通过了自身的就绪检查。memoryUsefulness: 40 是表现最弱的维度——请跟踪这一指标，将其作为 AgentDB 层未来记忆工作的先行指标。

CI 集成

node plugins/ruflo-metaharness/scripts/score.mjs --alert-on-fit-below 70 --format json

退出码为 1 时，构建将失败。搭配 harness-genome 使用，可查看完整的 7 个部分。

优雅降级（ADR-150 架构约束规则 #3）

当未安装 metaharness 且 npx 无法获取它时（离线、 无网络、注册表不可访问），脚本会输出：

{
  "degraded": true,
  "reason": "metaharness-not-available",
  "hint": "Install with `npm i -D metaharness@~0.4.1` (pinned range — this plugin never fetches @latest) or verify network access for the one-time cache install."
}

并以退出码 0 退出。Ruflo 将继续正常运行——这正是架构约束的实际体现。

评论

支持 Markdown