SuperAPI AI 工具集

ub-governance

部署与运维

查看项目

更新于 10-28 16:10

技能介绍

概述

UB Governance 用于在当前采纳该技能的项目或仓库中承担治理职责。它对常规工作流保持精简,只在所选模式或范围确实需要时启用更重的控制。技能内嵌的基础契约不依赖外部文档即可生效。

主要能力

  • 治理门禁:仅使用 pass、fail、blocked 三种门禁状态,并将阻塞性治理决策绑定到确定性产物。
  • 配置分层:默认使用精简配置(lean),仅当用户明确要求并给出理由时使用高级配置(advanced)。
  • 例外管理:每个有界例外必须包含 owner、rationale、created_at、expires_at、follow_up。
  • 升级判定:普通 Level 1 工作流工作以工作流产物作为默认持久操作记录;仅当决策跨越单一计划、覆盖全仓库、属高风险或被明确要求 Level 2 治理时才升级到 ADR 与 claim 机制。

运行模式

  • repository 模式:仓库卫生、CI 与发布治理、分支或规则集策略、确定性工具链。
  • testing 模式:行为优先的 TDD 治理与低信号测试反模式审查。
  • evidence 模式:证据生命周期、ADR 对齐、claim 验证与门禁就绪度。
  • core-contract 模式:共享的配置、门禁、例外与报告语义。
  • full governance audit 模式:按确定性顺序执行 repository、testing 和 evidence 检查。

测试信号模型

阻塞信号:

  • TG001 类型冗余:运行时测试重复类型系统已保证的内容。
  • TG002 交互但无结果:交互断言缺少可观察结果断言。
  • TG003 直通测试:无意义的 getter/setter 直通测试。
  • TG004 仅快乐路径套件:反复聚焦快乐路径,缺少边界或错误表示。

仅警告信号:

  • TG005 内部细节偏向:可能验证内部细节而非公开行为。

功能真实性信号按风险分级指导,不自动新增门禁:

  • TG006 本地源码模拟:测试替换了所审查行为涉及的本地应用源码。
  • TG007 无契约测试替身:mock、stub、fake、fixture 或路由拦截缺少可见的边界理由或契约证据。
  • TG008 模拟主导测试:测试主要是替身设置或调用断言,而非可观察结果。
  • TG009 缺失功能防护:风险行为缺少公开表面的功能、集成、契约、组件或 E2E 检查。
  • TG010 变更逻辑上的变异幸存:在变异证据已纳入范围时,变更的关键逻辑存在未审查的幸存变异体。
  • TG011 仅快照/覆盖率证明:行为变更仅依赖快照、渲染冒烟、覆盖率或“不抛错”证明。

使用方式

根据触发条件按需加载参考文档,未触发时不读取:

  • 决策边界阶段:在判断工作流产物是否足够、是否需要升级 ADR 与 claim 时,阅读 references/decision-memory-and-claims.md。
  • 测试模式:审查测试策略或应用测试反模式模型时,阅读 references/testing-policy-and-signals.md;涉及 TDD 执行顺序、回归优先的缺陷修复或测试工作流卫生时,阅读 references/execution-playbook.md。
  • 命令或审计阶段:用户询问如何运行检查或正在执行审计路径时,阅读 references/governance-commands.md。
  • 术语或规范化边界:仅在需要术语帮助或措辞规范化时,阅读 references/vocabulary.md。
  • 仓库模式边界:仅当仓库治理确实在范围内时,阅读 references/repository-baseline.md、references/github-implementation-playbook.md 和 references/release-please-playbook.md。
  • 证据 Level 2 边界:仅当明确 Level 2 或证据密集型治理启用时,阅读 evidence-baseline、evidence-lifecycle、evidence-artifact-taxonomy、ci-artifact-contract 和 stack-baseline 等参考文档。
  • schema 或数据边界:仅在编写或校验具体产物时,阅读 high-risk-paths.yaml、agent-validation-record.schema.json、adr-registry.schema.json、claim-register.schema.json 和 adr-template-madr.md。
  • 编写约定边界:仅在调整路由或共享编写结构时,阅读 ../ub-authoring/references/authoring-conventions.md。

核心工作流:从仓库事实中检测请求的治理模式与评估范围;选择配置(默认 lean);普通工作流工作优先走 Level 1 快速路径;仅在范围、风险或明确治理运行需要时升级;运行所选模式的控制并保持输出确定性;仅通过规范例外契约应用有界例外;输出带产物路径的可追溯门禁结果。

适用场景

  • 判断某次认证变更是否需要 ADR 或 claim 工作。
  • 检查测试是否主要在断言 mock 调用而缺少用户可见结果断言。
  • 执行仓库、测试与证据的完整治理审计。

限制

  • 不用于工作流接收、PRD 塑造、路线图生成、冲刺准备或可恢复的计划编排,这些应交给 ub-workflow。
  • 不用于框架特定的实现指导(当任务涉及代码变更而非治理策略或门禁语义时)。
  • 不用于通用文档规范化(当 ub-quality 是实际负责方时)。
  • 仓库自身的 README、AGENTS、技能 schema 等维护检查不属于本技能治理范围。

输出要求

产生非平凡治理输出时需包含:environment_note、scope_note、decision_note、gate_note、exception_note、validation_note。测试模式附加 quality_gate_note;证据模式附加 evidence_inventory 和 claim_note。