SuperAPI AI 工具集

comprehension-check

通用与其它

查看项目

更新于 10-16 02:32

技能介绍

用途:Comprehension Check 用于在 AI 生成或辅助的代码进入版本控制前,强制开发者真正理解每一处改动。其核心原则是“理解先于提交”:若无法用日常语言说清每处修改,就不应提交。

触发时机:改动涉及 3 个及以上文件、非平凡的算法或数据结构实现、结构性调整(新模块、数据流变化、依赖重连)、安全相关代码(认证、加密、输入清洗),以及自主智能体做出的决定。单字符或拼写修正、开发者逐行口述的改动、纯样板生成(脚手架配置、锁文件)可跳过。

主要能力:实现完成后、提交前,对每个被修改文件输出结构化走查,包含四项:WHAT(现在有何不同,描述含义而非 diff)、WHY(为何做此改动)、CONTEXT(与整体改动集如何交互)、HAZARD(引入哪些失败模式)。随后输出“结构性后果”(新增依赖、新增中间层、请求生命周期变化)与“开放问题”。

使用方式:走查完成后,直接询问“你是否完全理解这些改动并希望继续提交?”,并彻底解答开发者的疑问。对于超出原始请求的改动,须以“HEADS UP”形式披露并询问保留或回退。

适用场景:与 delegated-execution、test-first、parallel-execution 等流程衔接,在 completion-gate、merge-protocol 之前使用。

限制与护栏:禁止未阅读走查即提交 AI 代码、禁止隐瞒非请求改动、禁止在开发者困惑时草率推进、禁止把测试通过等同于真正理解。资料未提供具体安装命令、收费或平台信息。