SuperAPI AI 工具集

recipe-quality-audit

测试与质量

查看项目

更新于 10-16 02:39

技能介绍

用途:对单个或全部 NVCA 配方进行质量审计,生成结构化评分卡,并可按需更新质量跟踪表。

主要能力:分三层检查。Tier 1 结构检查(无需下载源文件):文件清单(metadata.yaml、replacements.json、clean.json,可选 computed.json、normalize.json、selections.json)、元数据 schema 校验、字段到替换项覆盖、歧义键(长度小于 8 且无上下文限定)、智能引号覆盖、source_sha256 是否存在、测试夹具是否存在。Tier 2 行为检查(需下载源文件):统计源中括号占位模式、替换覆盖率(目标大于 80%)、未匹配下划线模式、clean 有效性。Tier 3 填充质量(需运行填充):默认值填充、全值填充、格式异常计数、零匹配替换键。

使用方式:指定配方运行审计,例如“Audit the recipe: nvca-certificate-of-incorporation”,或审计全部配方并更新质量跟踪表。流程为读取 content/recipes/QUALITY_TRACKER.md,依次运行可执行的层级检查,计算评分卡与成熟度等级,输出 JSON,必要时更新跟踪表。

成熟度分级:scaffold 仅元数据无法填充;beta 有替换与 clean 但得分低于 11/15 或无测试夹具;production 得分不低于 11/15 且有测试夹具,若源含条件段落还需 computed.json。

限制:仅操作本地仓库文件,无需网络与凭据;Tier 2 源文档下载仅从已知模板源 URL 获取;Tier 2、Tier 3 分别依赖源文档与测试夹具是否可用。实现上使用 validateRecipeMetadata()、ensureSourceDocx()、runRecipe(),括号模式检测以 [[_A-Z] 前缀避免误计引用,零匹配键来自 PatchResult.zeroMatchKeys,并可与 cleanConfig 的 removeRanges、removeParagraphPatterns 交叉核对以抑制预期零匹配。