用途:在任何编码任务开始前,先写出一份可测试的契约,用独立评估者无需了解你的意图或推理即可验证的方式,界定“完成”意味着什么。若已开始编码才想起,应立即补写;契约在项目开始时使用,若检测到 Superpowers 则跳过本技能,由其 brainstorm/plan 产出规范。
主要能力:将契约写入 .harnessed/contract.md,格式含标题、任务、验收标准(功能/边界/回归子节)、验证命令、范围外。每条标准必须可独立验证、可观察、原子、无歧义、明确预期值;不得主观、规定实现、不可测试或冗余。标准计数建议:标准任务 3–8 条,大型任务 8–15 条,超过 15 条应拆分。验证命令示例:npm test、pytest、go test ./...、curl http://localhost:3000/endpoint、grep -n "pattern" file.ext,无法自动化的标记为 Manual。
使用方式:先读用户请求,识别显式与隐含需求;检查代码库模式、测试基础设施与约束;如 .harnessed/failure-patterns.md 存在,仅关注 Count ≥ 2 且与当前领域相关的失败模式;如 .harnessed/policies/ 存在,按领域选取相关策略(auth.md、response.md、db.md、validation.md、security.md、testing.md),文件应短于 50 行,仅按路径与关键词匹配相关项,不加载整个策略库。起草契约,补充验证命令,写明范围外,写入文件,强制做覆盖校验(把原始请求每个需求映射到至少一条标准),向用户呈现摘要。标准任务呈现后即可继续编码,大型任务需等待明确批准。
限制:若需求变更,须更新契约,绝不能用过期契约跑 QA;若变更根本性改变任务,应归档旧契约重写。若无可验证标准,说明任务过小或需求不清,应先询问用户。未提供具体环境差异或官方实施细节。