SuperAPI AI 工具集

check-impl-against-spec

通用与其它

查看项目

更新于 10-16 07:21

技能介绍

用途:在 PR 审查期间,判断已检出 PR 的实现是否与已批准的规格上下文实质性一致。仅在 spec_context.md 存在时使用,它是常规代码审查的补充,不单独产出报告。

输入:spec_context.md 提供比对用的规格上下文,可能同时包含产品规格(预期行为、验收标准)与技术规格(实现细节、文件变更);pr_diff.txt 提供带注释的 PR 差异;pr_description.md 可能包含额外范围或理由;工作区包含 PR 分支内容。

流程:先读取 spec_context.md,提取其中明确承诺的内容,包括必需行为、需要变更的文件或子系统、已声明的约束、必需的后续步骤、验证或迁移。再将这些承诺与 pr_diff.txt 及已检出文件中的实际实现比对。若小范围实现调整保持了规格意图,视为可接受;命名、结构或底层技术上的无害差异不标记。仅在实质性偏差时标记,例如产品规格要求的行为缺失、实现与规格决策矛盾、引入大量计划外范围、技术规格要求的验证、迁移或兼容步骤缺失。

输出:不创建单独报告文件,将规格一致性发现并入 review.json。宽泛的规格漂移问题写入审查摘要;仅当偏差能对应到差异中的变更行时才添加行内评论。实质性规格漂移至少视为重要关注点。若实现与规格足够一致,不要仅为说明一致而添加评论。

边界:当 PR 安全地达成相同结果时,不要求逐字逐项实现规格;不推测 spec_context.md 中实际不存在的内容;不直接发布到 GitHub。