用途:为 Duhem 编写 Verification Definition(VD),即包含功能验收标准(criteria)与机械校验(checks)的结构化 YAML 产物。用于为 Duhem 产品面规格提供示例、为 Duhem 仓库本身或作为首个 dogfood 客户的 Onsager 仓库编写 VD,或在用户要求“写标准”“把标准翻译成校验”时使用。纯内部脚手架改动、或要求 Onsager 自身规格时跳过。
主要能力:采用两层结构——criterion 为自然语言、人工编写、跨实现稳定;checks 为结构化 YAML、可由 AI 翻译、经人工审核后冻结,一个 criterion 对应一个或多个 check。提供从骨架到校验的编写循环:用 duhem init --name <slug> 生成可运行骨架(产品 VD 用 duhem init --name <slug> .duhem/<slug> 或复制 templates/product-repo/);提升标准;校验标准的稳定性与意图;翻译为标准对应的 steps + assertions;审查整体环境成本;自校验;保存并注册。
使用方式:以检索而非记忆获取版本精确契约,使用 duhem actions、duhem describe <uses>、duhem mcp 或 docs/action-reference.md;用 duhem validate 闭环校验 with: 键、输出字段与封闭枚举值。编写规则包括:被断言的步骤需有 id:,输出用 $steps.<id>.outputs.<name> 全路径引用,异步观察步骤显式设 timeout:,用基于角色的定位器,无 assertions 的 check 视为脚本应拒绝。可由 manifest include 共享定位器、由 flows: 复用步骤序列。
适用场景与限制:适用于以真实端到端行为验证功能的场景,默认不 mock,需数据前置时用 db/seed 或 event/publish 置于 setup:。判定须为机械谓词,仅限布尔表达式、类型检查、模式匹配、集合成员、存在性、跨步骤一致性六种形式;禁止 LLM 评分、禁止 mock 动作类型。capture/ 前缀为运行器失败证据保留,不可由作者绑定。若标准无法机械验证,应改写或明确标注,不可用 mock 掩盖。