Agent Skills
返回列表
💻

Attest 规范符合性验证

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/attest。

技能介绍

要解决什么问题

实现已经写完,但「是否满足规范里的验收标准」往往仍靠人工对文档、翻代码、猜测试是否覆盖。规范里 AC 含糊、ID 不一致,或实现与 Scribe/Accord 产出脱节时,发布决策缺少可审计的 PASS/FAIL 与 file:line / spec:section 证据链。

Attest 定位为规范符合性验证器:只验证、不审样式、不改代码;缺口通过交接 token 交给 Builder、Scribe/Accord 或 Radar。

如何工作

工作流为 INGEST → EXTRACT → GENERATE → VERIFY → ATTEST,并支持 FULL / EXTRACT / AUDIT / ADVERSARIAL 等模式(默认可自动推断)。

  • EXTRACT:从规范构建 AC 集(ID、优先级、可测性、AMBIGUOUS_FLAG),并按 IEEE 1012-2024、ISO/IEC/IEEE 29148 做质量与 V&V 深度校准。
  • GENERATE:为每条标准生成 BDD 场景(SC-*),Gherkin 面向业务语义,不嵌入 CSS/API/DB 实现细节。
  • VERIFY:将实现与每条 AC 对照,产出逐标准裁决与证据;存在 .traceability.yaml 时作为验证器填写 verdict、重算覆盖,不发明缺失 ID。
  • ATTEST:聚合为符合性报告、可追溯性矩阵与总体裁决(CERTIFIED / CONDITIONAL / REJECTED);对 FAIL/PARTIAL 配对可粘贴的 ## LLM Fix Prompt(如 CLOSE-GAP、RECONCILE-SPEC)。

常见配方包括 verify(实现后全链路)、bdd/gherkin(实现前场景)、trace/report(审计与覆盖缺口)、以及 property / oracle(属性测试与测试预言设计)。

边界与注意点

  • 无规范时应报 SPEC_MISSING,不要假设未指定行为;存在 CRITICAL 违规时不得批准。
  • BDD 用于实现前共识,不是把场景写成 QA 自动化脚本;单场景只断言一种行为。
  • 编写/更新规范 → Scribe/Accord;写测试 → Radar/Voyager;修代码 → Builder;非规范符合性的代码审查 → Judge。

使用场景

  • Builder 合入关键路径特性前,需对照 Accord/Scribe 规范逐条 AC 裁决并拿到 CERTIFIED 或带证据的 REJECTED
  • 实现尚未开工,只有需求文档,要从规范提取 AC 并按优先级生成 Given/When/Then 场景供 Radar 写测
  • 项目已有 `.traceability.yaml`,要在发布前核对每条 AC 的 verdict、正向/反向覆盖并列出 orphans 与 gaps
  • 对支付或权限类实现做 ADVERSARIAL 探测,在静态证据基础上找出规范未写清的边界与对抗缺口

适合人员

  • 负责发布门禁的技术负责人,需要在关键特性上依据逐标准证据给出 CONDITIONAL 或 REJECTED 而非口头「差不多」
  • 在 PDM/Accord 交付前写验收标准的业务分析师,希望 ISO 29148 质量检查与 BDD 场景在编码前就对齐干系人
  • 维护测试策略的 QA 架构师,要把 Radar 覆盖数据与规范 AC 做 AUDIT,定位 CRITICAL 无测项并交给 Radar 补测
  • 受监管或审计要求的交付 Owner,需要带可追溯性矩阵与 spec:section 引用的符合性报告留档