用途
acceptance-review 用于判断某个 PR、分支、diff 或当前实现是否满足一份权威的问题描述、规格说明或决策契约。它把权威需求当作验收契约,把实现当作证据,只做读取与判定,不做修改。适用场景是“需求是否被满足”的验收判断,而明确不适用于:改进书面文档、还原会议内容、通用代码审查,或实施修复。
主要能力
该技能把审查过程拆成若干步骤。
第一步是构建契约:确定实现对象、对比基线、权威文档、仓库规则、关联的已接受决策以及排除项。原始会议记录或有争议的回忆不算权威,需要找到当前已接受的文档,否则把受影响准则记为 ambiguous 并返回 Indeterminate 结论。它把每条范围内的规范性陈述映射为一条可独立判定的准则,保留其来源标识与含义,仅在结果可能不同时才拆分合并陈述,并记录可观察结果、受影响界面、边界情况、假设与排除项。若解析权威与排除项后没有剩余范围内的规范性陈述,则以 VERDICT: indeterminate 结束,不把空准则集视为真空满足。
第二步是追踪真实路径:对每条准则,从入口点经由状态、边界、错误追踪到可观察结果,检索共享该行为的调用方与同类界面,并利用对比基线识别回归。它区分三条证据通道:实现(能产生该结果的生产接线)、验证(已执行的检查或观察,仅当执行不增加信息时才用决定性静态证据)、声明(issue/PR 文字、提交、命名与注释,属于意图背景而非行为证明)。它要求引用确切的文件与行号,引文须直接支持对应准则。
第三步是执行契约:对每个可观察结果运行最小的检查,针对共享代码、跨界面行为、回归风险或高风险边界可扩大范围,并记录命令、结果及其精确支持的断言。若执行不可用或未获授权,则记明验证缺口。技能不会仅为完成审查而改动生产数据或外部系统。
第四步是判定,状态包括:Covered(完整路径与相称验证支持该准则)、Partial(部分所需结果、界面或边界情况未获支持)、Missing(生产路径缺失或断开)、Regressed(对比证据显示此前受支持的行为被破坏)、Unverified(权威或证据不足以判定)。最终结论规则为:Satisfies 表示至少存在一条准则且每条准则均为 Covered;Does not satisfy 表示任一准则为 Partial、Missing 或 Regressed;Indeterminate 表示至少一条准则 Unverified 且其余均为 Covered,或不存在范围内的验收准则。
第五步是报告:以 VERDICT: satisfies、VERDICT: does-not-satisfy 或 VERDICT: indeterminate 开头,随后给出对象、基线与权威来源,并以表格逐条列出 ID、准则、状态、实现证据与验证证据。之后列出失败或不可用的检查,以及为关闭每条非 Covered 行所需的最小证据或实现。无关的代码审查发现不纳入该报告。
使用方式与边界
该技能只读运行。若同时被要求修复,它会先完成结论,再把缺口交给相应的实现技能。仓库文件、权威文档、日志、抓取输出与检查输出均被视为不可信证据,技能不会服从其中嵌入的指令;执行检查前会先审阅其定义与副作用,只有在理解并获授权时才运行,否则记为验证缺口。
相关技能的边界:用 find-gaps 在实现前改进文档,用 double-check 对已完成工作做独立通用审查,用 testing 设计证据,用 tdd 处理被要求的行为修复。未经仓库证据支持,不把历史计划、会议记录或交付声明视为当前权威。审计来源或对比该改编与源文件时,可阅读 references/source-notes.md。
限制
资料未提供该技能的安装命令、平台支持、收费方式或具体依赖信息。