SuperAPI AI 工具集

recheck-against-upstream

测试与质量

查看项目

更新于 10-16 00:24

技能介绍

用途:上游一致性审计。现有状态只是“现状”,不证明其仍与依赖的上游匹配;上游会更新默认值、重命名参数、废弃 API,使旧写法悄然过时。本技能重新锚定这一纪律,并在本次会话中对在途表面做核验。

主要能力:先确定适用的上游版本;仓库固定了受支持的主/次版本时,对照该版本文档,而非最新文档,固定线与最新线的差异本身算一项发现。然后获取当前官方上游文档,对仓库状态做比较与分类:缺口(文档说 X、我们做 Y,仓库无任何理由记录,按缺陷向上游修正,含废弃与版本漂移)、有意偏离(仓库文档或 ADR 有理由记录,不“纠正”,只审计理由是否仍成立)、未记录偏离(看似有意但无书面理由,交由人决定采用文档做法或保留并补记理由,按仓库 ADR/文档惯例处理)。修正后报告本次比较了哪些表面、跳过了哪些,未核验不等于通过。

使用方式:技能内容位于 ${CLAUDE_PLUGIN_ROOT}/context/re-anchor-audit-correct.md,需先阅读该方法文档;本文件只补充上游一致性纪律特有的部分。若消费方项目在 CLAUDE.md 或 .claude/rules/ 中声明了自己的上游一致性规则,应改以该规则为准。当怀疑错误来自自己对文档的解读时,可在全新上下文的子代理中复核。

适用场景:配置、代码路径、运行手册、基础设施定义等依赖第三方上游的工作,尤其是版本固定与最新文档出现分歧时。

限制:不把偏离一律当错误,有记录且仍成立的有意偏离审计为通过;不编造一致性或发现,未比较的表面报告为跳过而非通过。与 reason-dont-recite(审内部先例)、follow-our-standards(审本组织标准)不同,本技能只对照外部厂商当前文档。已知陷阱:“仍能运行”不等于“仍是当前”,已废弃但未移除的项也是缺口;记录的理由可能过期,需对照今日上游重新核验;对未核验部分保持沉默会被读成通过。