SuperAPI AI 工具集

hrt-align-consistency-review

编程与开发

查看项目

更新于 10-15 22:12

技能介绍

用途:在编写代码之前,验证 tempa-spec 各工件彼此一致、忠实于需求,并确保有人类真正阅读过,而不只是智能体互相核对。

循环结构:每轮依次为 ALIGN(检查跨工件一致性)、VERIFY(由全新上下文的子智能体复核 ALIGN 的映射并修正;仅当本轮 ALIGN 未产生 HIGH、MEDIUM、LOW DECISION 发现且 lint 干净时跳过)、WALKTHROUGH(向人类展示完整工件清单并询问一次是否需要修改)。WALKTHROUGH 的反馈重新进入 ALIGN,直到某轮 WALKTHROUGH 无新反馈或用户提前签字确认。每轮开始时报告轮次编号;第三轮仍未结束循环时,询问用户继续还是签字,不自行停止。

ALIGN:重读全部工件,运行 openspec validate --strict 与 hrt-artifact-lint 技能,直接修复每个 lint ERROR 并记为 MECHANICAL 发现,记录 lint 是否干净。design.md 为必需,缺失记为 HIGH。随后按 9 个维度建立一致性映射:discovery→proposal、proposal→specs、proposal↔design、specs↔design、specs→tasks、design→tasks(安全通过时)、specs↔seams、tasks 依赖图、spec 结构、design/tasks→代码库。仅机械化存在性/引用/结构部分,语义判断不可用关键词匹配替代。

分类:先过后果门,能指出下游具体故障才为 HIGH 或 MEDIUM,其余为 LOW。HIGH 包括工件间矛盾、能力无 spec、需求无覆盖任务、破坏解析的结构错误、无法追溯的 Desired Outcome、与代码库不符的声明。MEDIUM 包括部分覆盖、模糊或不可测需求、无设计决策的技术选择、任务过粗或错序、未场景化的边界情况、场景无 seam 可挂。LOW 包括术语漂移、措辞、格式、顺序等。每条发现标记 MECHANICAL(唯一正确修复且有可重跑锚点)或 DECISION(多种有效解法、涉及范围或意图,或无锚点)。

处理:MECHANICAL 直接修复并记录;HIGH/MEDIUM DECISION 逐条呈现给用户,先中立说明权衡再给建议,需获得实际解决或明确有理由的推迟;LOW DECISION 批量列入 align.md 的 Known Issues 并一次性展示,不阻塞。每条 HIGH 须被修复或被用户明确排除范围并记录理由。结果追加到 align.md,决策与已解决 HIGH 需给出文档与章节来源指针。

VERIFY:由无 ALIGN 记忆的子智能体仅接收当前工件与 ALIGN 第 2 步清单,重新推导映射,报告 ALIGN 遗漏的 HIGH 及 MECHANICAL 修复是否正确。发现新 HIGH 或修复无效则并入本轮映射并按规则解决,不再重复 VERIFY。无法生成子智能体时须说明并询问用户是否继续。

WALKTHROUGH:每轮必做,按构建顺序列出全部工件,提出一个覆盖整个清单的通用问题,记录用户原话。不得从沉默或无关回答推断完成。

结束循环:回答为“无”则结束并进入 apply;有反馈则开启新循环;用户可在至少完成一轮 WALKTHROUGH 后提前签字;第三轮后询问继续或签字。不得以其他依据进入 apply。

限制:资料未提供具体安装命令、收费、价格、平台或效果信息。