SuperAPI AI 工具集

aep-validate

测试与质量

查看项目

更新于 10-16 00:28

技能介绍

用途:对 AEP 工作流产出的任意制品(代码、文档或规格)执行生成者/评估者模式的验证。核心原则是产出制品的智能体无法诚实地评估自己的作品,因此通过角色分离来避免自我称赞导致的误判。

主要能力:生成者以试运行方式尝试使用制品,评估者对照现实(代码库、约束、下游协议)进行检查,结果汇总后应用到制品本身。适用于产品上下文(product-context.yaml 与 product/index.yaml)、OpenSpec 变更、设计文档、代码等制品;也支持在 /aep-envision、/aep-map、/aep-design 等阶段后单独调用。

使用方式:先确定验证目标与模式(A/B/C/D)。产品上下文需区分 split 与 v1 模式。启动智能体前先运行确定性预检:node scripts/coherence.mjs --context product-context.yaml,该命令在存在阻塞性发现时以非零退出并打印修复建议。随后按模式配置并并行启动智能体(如产品设计评估器、愿景对齐检查器、生成者、评估者、协议检查器),各自独立工作。

结果处理:将各智能体发现按阻塞、重要、次要分类并合并去重,先向用户展示计数结果,再修复所有阻塞与重要问题;仅修改被验证的制品,不新建文件或实现代码。无法自行决定的问题标记为 open_question。若制品为 product-context.yaml,提交前需确认 npx js-yaml product-context.yaml 退出为 0。最后按 git 流程提交并推送到集成分支。

限制:不适用于 /aep-build 第 5 阶段(应使用内置评估器循环);不用于主观质量评价(应使用 /aep-design-lens);单文件编辑或错别字等微小改动无需三智能体验证。其验证聚焦事实正确性与完整性,而非美学判断。参考资料中提及的角色契约、评分框架、模式说明等细节,本技能未完整展开。