mcpField
R
review-harness-spec

review-harness-spec

github.com/hedera-dev测试与质量28479 次安装8 周前更新
代码仓库

关于 review-harness-spec

这是一个仅用于编写阶段的技能，用于在生成前审查 hedera-harness schema v3 配方。它分别检查配方连线和评估质量，并整理结果以判断是否适合运行 ASSERT。

主要功能

  1. 01检查 schema v3 配方连线
  2. 02运行仅针对配方的验证
  3. 03审查 PRD 与评估的对应关系
  4. 04评估断言、严重性和范围
  5. 05分别报告连线与评估问题

适用场景

  1. 01运行 ASSERT 前审查配方
  2. 02发现缺失或不一致的配方文件
  3. 03检查评估是否覆盖 PRD 流程
  4. 04识别脆弱的 needles 或范围蔓延

安装

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

$npx skills add https://github.com/hedera-dev/hedera-skills --skill review-harness-spec

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
evals.json
spec.json
references/
review-checklist.md

详细介绍

Review Harness 规范

从两个维度审查磁盘上的 hedera-harness 配方。找出那些只有在生成器尝试已经开始消耗资源后，harness 才会暴露的问题。

先加载共享词汇表：阅读 ../harness-spec-anatomy/SKILL.md 和 GLOSSARY.md。

目标版本：hedera-harness schemaVersion 3。

仅用于编写的技能。配方不会列出技能。

第 1 步：定位配方

配方位于项目根目录下的 .harness/spec.yaml。读取它解析到的每个文件，并记住 v3 会为大多数路径设置默认值——键缺失不代表文件缺失：

键缺失时的默认值
prd.harness/prd.md（列表表示增量）
eval缺失（EVALUATE 关闭）。列表必须与 prd: 一一对应
validators.static.harness/validators/static.json
validators.commands.harness/validators/yarn.json

如果配方文件缺失，请停止并询问。如果 schemaVersion 缺失、为 1 或 2，请停止并建议重写为 v3（将 contract: 改为 eval:，删除 skills:，设置 schemaVersion: 3）——或使用 hedera-harness init 重新生成。 migrate 已移除。请审查重写后的配方，而不是过时的原始配方。

第 2 步：接线维度

bash <path-to>/harness-spec-anatomy/scripts/check-spec.sh <project-root>

<project-root> 是包含 .harness/ 的目录。脚本会运行 hedera-harness doctor --recipe-only 来验证架构，然后添加跨文件一致性检查。

在 ## Wiring 下逐字报告其结果。

如果报告指出架构未经过验证（harness CLI 缺失或版本过旧），请在报告中明确说明——此时接线维度为部分通过，而非通过。

第 3 步：评估维度

仅作判断——这是脚本无法检查的部分。按照 references/review-checklist.md 逐项检查。至少涵盖：

  • 每条 PRD 用户旅程都映射到对应评估清单中的 ≥ 1 项断言
  • 每项断言都可追溯到一条 PRD 用户旅程（没有孤立项／范围蔓延）
  • 严重性预算合理（最好不超过 2 项 critical）
  • Needles 锁定真实脚本，而非脆弱的实现字符串
  • Playwright 阶段保持精简；深入的 UX 检查放在清单中
  • 没有 skills: 键（产品插件会被发现；生成器会进行选择）
  • 配方没有填入仅仅重述默认值的内容
  • 对于增量：每个增量完成后应用都能正常运行；增量按依赖关系排序；并且 eval: 与 prd: 一一对应

在 ## Eval 下报告。不要与 Wiring 合并或重新排序——配方可以接线完全正确，但仍然评估错对象。

第 4 步：输出报告

# Harness Recipe Review — <slug>

## Summary
- **Schema**: v3 | stale (rewrite first)
- **Stage ambition**: ASSERT | +SMOKE | +EVALUATE | +CHAIN
- **Increments**: single PRD | N ordered (eval paired: yes / no / scalar)
- **Ready to run ASSERT?**: yes / no
- **Wiring findings**: N  (schema validated: yes / no)
- **Eval findings**: N

## Wiring
- [script output or hand-checked findings]

## Eval
### Blocker
- [id] <what> — <where> — <fix>
### Warning
- [id] <what> — <where> — <fix>
### OK
- [id] <what>

第 5 步：交接

如果可以进入 ASSERT：

hedera-harness run .harness/spec.yaml --max-attempts 3
# or: yarn harness:run

其他资源

评论

支持 Markdown