SuperAPI AI 工具集

verification-methodology

测试与质量

查看项目

更新于 10-16 09:25

技能介绍

用途

Verification Methodology 是一个用于对工件、主张或实现进行通过/失败评估的技能。它要求验证工作基于预先定义的标准,使用直接、忠实于来源的证据和可复现的检查,并给出清晰的裁决。该技能应在宣布某个工件完成之前使用。

主要能力

验证协议

技能定义了一套验证流程:

  • 接收:重述被验证的工件、主张或实现,以及该验证将支持的决策。
  • 评估标准:将需求转化为可观察的通过/失败条件;识别什么会反驳每个主张。
  • 调查:从请求指定的来源收集直接、可复现的证据,并记录命令、来源位置或来源URL。当来源可访问时,应自行收集证据,不要要求用户转达你可以自行获取的证据。仅请求你确实缺乏的访问权限。
  • 决策:将每个标准标记为通过、失败、受阻或不适用。不要将缺失证据转化为通过。
  • 报告:使用裁决模板区分已验证事实、假设和剩余工作。

当验证被拆分到多个通道时,任何单个通道的 PASS 都不是最终裁决。必须等待所有必需通道,并在综合前协调冲突。

后续的来源忠实度 BLOCK 会取代同一工件哈希的早期散文、渲染或清单 PASS。应立即将早期 PASS 包标记为已取代,以免下游工作者将其误认为当前裁决。

模式扫描和内部一致性不能替代对照指定主要来源或来源档案检查事实转换。

当每个标准都有直接证据或明确的受阻/不适用裁决时停止。当标准模糊、证据冲突或所需访问不可用时升级。

来源忠实度

  • 将请求或配置的本地服务视为验证标准的一部分,而不是可互换的主题标签。
  • 在相邻集成、通用网络搜索或公共项目来源之前,加载匹配的技能并使用其文档化的可执行文件或服务路径。
  • 使用技能自身解析的路径。全局 PATH 条目缺失并不证明捆绑的可执行文件不可用。
  • 如果直接来源失败,报告尝试的命令或端点及其确切失败。不要静默替换为其他来源的证据。
  • 仅当用户请求更广泛的上下文或明确接受回退时,才使用替代来源。将替代证据标记为次要,不要将其呈现为所请求来源的状态。

示例:对于“Jellyfin 有什么新功能?”在配置了 Jellyfin 技能和捆绑 CLI 的环境中,应首先通过捆绑 CLI 查询该服务器。Home Assistant 实体和公共 Jellyfin 项目活动回答的是不同的问题。

不适用场景

不要将此技能用于没有工件、主张、决策或可观察完成标准的开放式探索。先使用研究或发现技能,当有可证伪的内容需要验证时再回到这里。

相关技能

  • playwright:作为验证工具的基于浏览器的端到端检查:针对真实 UI 边界编写和运行规范。
  • documents:将验证报告或证据包生成为 PDF/Word/Excel/PowerPoint 交付物。

参考文件

参考 何时加载
references/criteria-assessment.md 需要评估工作是否满足完成标准时
references/evidence-standards.md 需要判断证据是否支持所提出的主张时
references/magnus919-refine-to-ship-gate.md 运行 Magnus919 Refine-to-Ship 验证器门禁时——12项标准、编辑变更验证、输出结构
references/verdict-template.md 需要生成结构化的通过/失败/保留裁决时

Magnus919 Refine-to-Ship 门禁标准

验证器配置的12项标准。每项标准映射到一个可观察、可复现的检查。

# 标准 如何验证
1 破折号扫描——零 em dash (U+2014)、en dash (U+2013)、horizontal bar (U+2015) 或可见散文双连字符 搜索 [\u2014\u2013\u2015] 和 --。YAML frontmatter 分隔符中的双连字符可以。
2 事实核查——所有方法论主张映射到来源;无捏造数字、时间顺序或普遍主张 将文章主张与源文档章节交叉引用。搜索 \d+%、percent、average of、illustrative。搜索 research proves、studies demonstrate。
3 声音检查——Magnus 指纹:对话式第一人称、缩略、"But" 转折(非正式过渡)、冒号优于分号、无顾问式节奏 搜索 Furthermore、Moreover、Nevertheless、Consequently、Therefore、not only.*but also、三重排比。统计冒号与分号(应严重偏向冒号)。
4 牛津逗号、拼写、语法——美式英语、系列中的牛津逗号、无拼写错误 手动阅读系列。检查格式一致性。
5 无公式化 AI 结尾——零 "In conclusion"、"To summarize"、"In this article"、通用激励建议 搜索 In conclusion、Ultimately,、To summarize、In this article、In this post。
6 方法论优先——个人框架 ≤ 文章的约10%;其余为方法论 统计框架与正文的段落数。
7 人类利害关系整合——认知负担、专业知识形成、转移的工作、反监视、可问责权威 验证专门章节或分散覆盖所有维度。
8 隐私/匿名化——零公司标识符、角色头衔、具名人物、源文件名、专有领域示例 搜索公司名称、产品名称、来自来源的领域特定术语。
9 Frontmatter——title、slug、date、byline 正确且与规范值相同 读取第1-11行。
10 链接可解析——每个不同 URL 在首次有意义提及时出现一次;全部返回200 对每个 URL 执行 curl -s -o /dev/null -w "%{http_code}"。验证链接文本在首次有意义提及处。
11 Hugo 构建 + 路由——构建退出码0;新路由返回200;旧 take-home-title 路由返回404 hugo --quiet && echo EXIT:$?。curl 两个路由。
12 无重复源包——单一目录、单一 index.md;无过时的 take-home 目录 ls 页面包目录。在 content/posts 中查找重复 slug 模式。

父级请求的编辑变更

当父配置在门禁恢复期间指定编辑变更时,在继续完整标准扫描之前验证每个变更是否存在:

变更类型 验证方法
捏造的说明性数字已移除 搜索 \d+%、percent、PRs? per、average of → 零命中
时态更正 搜索父级指定的确切短语
结尾替换 搜索父级指定结尾的第一句和最后一句

裁决规则

  • PASS:满足所有12项标准。生成 00-index.md、01-summary/verdict.md、02-analysis/per-criteria-results.md。
  • BLOCK:任何标准失败。生成 gap-details.md,包含具体修复说明。参见 verifier-gate-recovery 技能了解修复模式。

输出结构

/private/tmp/verifier-gate/<slug>-refine/
  00-index.md              — 裁决,指向工件的链接
  01-summary/verdict.md    — 每项标准的通过/失败表
  02-analysis/
    per-criteria-results.md  — 每项标准的详细证据
    gap-details.md           — 仅在 BLOCK 时,包含修复说明

可移植性

此技能有意保持主机中立。使用你的代理的正常机制来加载此处列出的参考、模板和脚本。不要假设特定的配置系统、任务编排器、记忆服务或响应交接格式。

使用方式

该技能通过代理的正常机制加载,使用其提供的参考文件、模板和脚本。具体安装命令和调用方式暂未提供。

适用场景

  • 在宣布工件完成前进行严格验证。
  • 对实现、主张或工件进行通过/失败评估。
  • 运行 Magnus919 Refine-to-Ship 验证器门禁。
  • 验证编辑变更是否已应用。

限制

  • 不适用于没有工件、主张、决策或可观察完成标准的开放式探索。
  • 当标准模糊、证据冲突或所需访问不可用时需要升级。
  • 具体安装命令、平台支持、收费信息暂未提供。