SuperAPI AI 工具集

review-harness-spec

测试与质量

查看项目

更新于 10-16 05:50

技能介绍

用途:在运行 hedera-harness 之前审查磁盘上的配方文件,提前发现接线与评估检查清单层面的问题,避免生成器在错误配方上消耗尝试次数。

定位与前置:配方位于项目根目录的 .harness/spec.yaml,目标为 schemaVersion 3。该技能仅用于编写阶段,配方本身不列出技能。开始前先读取 ../harness-spec-anatomy/SKILL.md 及其 GLOSSARY.md 建立共享词汇。

主要步骤:

  1. 定位配方:读取 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(契约:→ 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 旅程对应匹配评估清单中至少一条断言;每条断言可回溯到 PRD 旅程(无孤立或范围蔓延);严重度预算合理(建议关键项不超过 2);needles 指向真实脚本而非脆弱的实现字符串;Playwright 阶段保持轻量,深层 UX 放在清单中;无 skills: 键;配方不堆砌仅复述默认值的条目;增量场景下每步保持应用绿色、按依赖排序、eval: 与 prd: 一一对应。结果列在 ## Eval 下,不与 Wiring 合并或重排。
  4. 输出报告:按固定结构包含 Summary(模式、阶段目标、增量、是否可运行 ASSERT、接线与评估发现数)、Wiring、Eval(Blocker/Warning/OK)。
  5. 交接:若可运行 ASSERT,则执行 hedera-harness run .harness/spec.yaml --max-attempts 3 或 yarn harness:run。

适用场景:需要在运行前系统审查 harness 配方正确性的开发与测试流程。限制:仅针对 schemaVersion 3;评估维度依赖人工判断;若缺少 harness CLI 则接线检查不完整。其他细节暂未提供。