SuperAPI AI 工具集

verify-openspec-docs

通用与其它

查看项目

更新于 10-16 07:20

技能介绍

用途:核查已完成的 OpenSpec 用户文档,检查正文与实际情况是否一致。使用全新上下文的目的是让审查者没有参与写作过程,从而不会接受作者的假设。该技能仅在用户主动请求时运行;草稿撰写由 write-openspec-docs 负责,除非用户要求验证,否则不要在撰写会话中调用本技能。\n\n使用方式:先确定核查范围(一个页面、一个 ## 小节,或一组变更的说法);若未给出目标则先询问。读取目标所在文档树根部的 README,其不变量与页面地图也属于核查内容。每个单元(一个 ## 小节或给定的一组说法)分配一个子代理,整页则拆成多个子代理并行运行。子代理为通用型,不继承技能,因此提示词需按绝对路径提供全部信息。\n\n主要核查能力:按顺序检查事实(每条命令、标志、路径、配置键、输出块、默认值与行为说法;重新运行终端命令,只读命令可任意运行,会改变状态的命令需在临时目录运行或不运行;AI 聊天界面的命令如 /opsx:propose 无法在 shell 中运行,则对照仓库中的技能源核对名称与行为;命令名对照 src/ 与 CLI 的 --help);示例(磁盘上存在的示例规范或变更须通过 openspec validate);结构(重复解释其他页面已有主题、违反文档树 README 规则之处);职责匹配;以及措辞问题(夸张形容词、无证据断言、二元对比、总结式结尾、破折号、应为散文的列表等)。\n\n报告处理:默认只报告不重写,按严重程度列出发现,每条包含引用行、问题说明和一行修复建议,并说明已验证内容及验证方式,列出无法验证的说法。仅在用户要求验证并修复或认可结论时应用修复;审查者也可能出错,拒绝理由需写入报告供用户裁定。若修复改动事实性说法,需针对改动范围再次验证;两轮未收敛则停止并交由用户处理,不做循环打磨。