用途:为 hedera-harness 配方提供单一事实来源,统一术语(须严格使用 GLOSSARY.md 中的加粗术语)。面向 schemaVersion 3,旧配方加载时直接失败,且没有迁移命令,只能改写为 v3 或用 hedera-harness init 重新生成后再套用修改。这些技能仅用于编写,不参与生成器运行;配方不列出技能,每次运行由生成器从 hedera-skills 的产品插件中按 PRD 需要挑选。
布局:唯一布局是脚手架应用内的 .harness/,工作区即项目本身,配方中的路径相对项目根。默认文件包括配方 .harness/spec.yaml、PRD .harness/prd.md、静态校验器 .harness/validators/static.json、命令校验器 .harness/validators/yarn.json、Playwright 冒烟 .harness/validators/playwright-smoke.yaml、评估清单 .harness/eval.json;均为默认路径,省略键即用默认,产物固定落在 .harness/runs/。交接命令:yarn harness:run 或 hedera-harness run .harness/spec.yaml。
配方必填仅四项:schemaVersion: 3、name、description,以及 baseline.commands(其中名为 install 的命令必需,用于安装指纹)。其余如 prd、validators.*、maxAttempts、agent、constraints、forbiddenFiles、secretScan、requiredFiles 均有默认或自动检测。baseline 与 validators.commands 不同:前者证明生成前项目健康,后者在生成后评分。
默认值:agent 为 claude;prd 为 .harness/prd.md;eval 缺省即关闭 EVALUATE;maxAttempts 为 3;包管理器从 package.json/lockfiles 检测;forbiddenFiles/secretScan 含 .env 及每个工作区一份;requiredFiles 为空。未知键会警告并忽略。
阶段按序启用,默认仅 ASSERT:ASSERT 检查文件、JSON/文本、密钥、安装/检查/构建;SMOKE 检查开发服务器启动、路由 HTTP 正常、控制台与禁用文本;EVALUATE 由智能体对编号断言评分;CHAIN 使用临时 ECDSA 测试签名者、真实交易与镜像验证。
跨文件一致性需保持:评估清单路由、Playwright 路由与 PRD 交付路由一致;每条 PRD 旅程至少对应一条断言;prd 列表与 eval 列表须 1:1;forbiddenFiles 与静态 fileAssertions.forbidden 对应;eval 与 validator.enabled: true 需同时设置。保持运行盲测:PRD 承载旅程与结果,编号断言放在评估清单。
机械检查:bash <path-to>/harness-spec-anatomy/scripts/check-spec.sh <project-root>,脚本路径相对已安装技能解析,先运行 hedera-harness doctor --recipe-only,再补充 doctor 未做的跨文件一致性检查;退出码为零表示接线干净。若 CLI 不可用,脚本仍运行一致性检查并说明,应视为部分结果而非通过。其他资源见 GLOSSARY.md 及 references/ 下各文件。