SuperAPI AI 工具集

evidence-governance

测试与质量

查看项目

更新于 10-28 16:10

技能介绍

用途

Evidence Governance 是一个面向应用交付的治理技能,用于在自主智能体参与开发时运行和审计「基于证据的开发」(EBD)。其治理对象为 Web 前端与 Python 后端服务,核心是确定性(deterministic)的治理模型,包含双通道验证、风险分层门禁、类型化制品、受限例外以及可审计的运行记录。

主要能力

  • 双通道模型:Lane A(探索)包括手动探查、本地预览、临时诊断,非阻塞;Lane B(门禁)为可在 CI 中执行、可从干净检出复现的确定性检查,阻塞。若 Lane A 的发现被用于决策,必须在门禁退出前转化为至少一个 Lane B 检查。
  • 风险分层:L0(琐碎,文档/文案/无行为重构,最少确定性检查)、L1(标准,常规功能与缺陷修复,完整合并门禁)、L2(高风险,认证、权限、支付、迁移、重大重构,合并门禁加扩展置信度检查)、L3(发布,生产发布就绪与上线/回滚证据)。默认 L1。
  • 变更分类:changeType 包括 ui-feature、api-feature、bugfix、refactor、security、perf、a11y、migration、release;evidenceLevel 为 L0–L3。
  • TDD 结果校验:对缺陷修复、功能与重构校验回归覆盖与验收标准覆盖。
  • 智能体验证记录:自主运行须输出符合 agent-validation-record.schema.json 的验证记录,记录工具链版本与运行时细节。
  • 例外管理:仅在不可避免时记录例外,需含负责人、风险、过期时间与后续跟进;缺失或过期的必备制品在无有效未过期例外时阻塞门禁。
  • 智能体安全控制:明确命令/路径/网络白名单,智能体上下文与日志中不得出现生产密钥,自主写入保留在可审查分支并需人工合并批准。

使用方式

  1. 识别当前阶段/发布上下文与验收标准。
  2. 对运行分类:确定 changeType 与 evidenceLevel。
  3. 依据 app-artifact-taxonomy.md 为所选分类定义必须满足的制品。
  4. 执行确定性 Lane B 检查并收集类型化制品。
  5. 校验 TDD 结果并更新运行记录。
  6. 必要时记录例外。
  7. 审计证据新鲜度与门禁完整性。
  8. 报告门禁决策为 pass、fail 或 blocked,并给出明确制品路径。

按需加载参考文档:evidence-lifecycle.md(证据树结构、新鲜度、保留与反模式)、gate-governance-and-exceptions.md(门禁规则与例外生命周期)、app-artifact-taxonomy.md(按 evidenceLevel × changeType 的必备制品与跨栈生产者示例)、tdd-outcomes.md(可执行的 TDD 结果策略与验收覆盖)、agent-validation-record.schema.json(验证记录字段与校验规则)、governance-baseline-2026-02.md(带日期的基线默认值与标准对齐);仅在明确涉及迁移专项对齐时读取 artifact-taxonomy-and-schemas.md。

输出要求

治理输出应包含:范围说明(阶段/发布、changeType、evidenceLevel)、证据清单(必备制品及其存在/缺失/过期状态)、通道说明(确认阻塞证据为 Lane B)、TDD 说明(回归覆盖与验收标准映射)、例外说明(有效例外的过期状态或明确为无)、决策说明(pass/fail/blocked 及精确路径引用)。

适用场景

产出或审计合并门禁与置信度门禁证据;按风险与范围分类变更;校验缺陷修复、功能与重构的 TDD 结果;为自主运行创建或审查智能体验证记录;审查、过期、续期或升级治理例外;为新阶段/发布规划证据目录与收集流程。

限制

该技能聚焦 Web 前端与 Python 服务的治理流程;缺失或过期的必备制品会阻塞门禁,除非存在有效未过期例外;自主运行需配置白名单并遵守人工合并审批。具体工具链、运行时细节与门禁阈值等实现参数需以所引用的参考文档和基线为准,资料中未提供进一步的默认值细节。