SuperAPI AI 工具集

session-governance-audit

部署与运维

查看项目

更新于 10-15 09:42

技能介绍

用途

Session Governance Audit 用于把一段原始的会话转录转化为可问责的治理记录。它回答四个问题:会话实际触碰了什么、消耗了什么成本、相对于被要求的内容交付了什么,以及——最重要的——什么是缺失的、属于哪种缺失。

该技能针对会话产生的一类失败模式:从外部看完全相同的两种失败,一种是“尝试过但未完成”的工作(Gap,缺口),另一种是“从未在任何地方被记录”的工作(Vacuum,真空)。收尾仪式能捕捉前者,只有一次刻意的全面扫查才能捕捉后者。本技能就是这次刻意扫查——一次“走廊巡查”,它汇编证据,而不是信任会话的自我报告。

核心原则

  • N/A 是真空,绝不是停滞状态。 任何解析为“N/A / 未知 / 未完成”的指标、交付物或任务,都必须成为输出中一个有名称的条目,绝不能被静默丢弃。
  • 证据优先于自我陈述。 转录中的声明(“已推送”“已修复”“已完成”)是假设;在将其记录为已交付之前,必须对照磁盘/远端逐一验证。
  • 审计本身也是一件产物。 索引必须是持久的(已提交或已归档),否则审计会变成它自己的真空。

工作流程

1. 确立被要求的任务集合

收集会话本应完成的所有内容:

  • 明确的用户提示(每个祈使句 = 一个任务原子)
  • 会话中编写或引用的计划文档
  • 会话声称的 IRF 行 / 登记项
  • 会话继承的交接文档

将其编号为 T-01 … T-NN。

2. 编制注释书目(已交付集合)

按时间顺序遍历转录,记录每个产物事件,字段包括:ID、产物、事件、证据、是否已验证。

规则:

  • 每个产物每类事件一行(一个文件先编辑后提交 = 两个事件)。
  • 验证每一行:提交用 git log/git show,文件用 test -f/内容 grep,推送用远端引用比对。无法验证的声明标记为 UNVERIFIED,而非已交付。
  • 纳入非文件产物:打开的 PR、提交的 issue、创建的分支、发出的外部消息。

3. 核算内部能耗

估算会话消耗的资源:

  • 工具使用:按类别计数(读/搜索 vs 写/执行 vs 网络)。
  • Token:从转录规模估算(字符数 ÷ 4),在可推导时拆分为输入/输出。
  • 墙钟时间:从首个到最后一个时间戳。
  • 子智能体/并行工作:单独计数并归属其能耗。

能耗数据为统计提供背景:一个烧掉 40 万 Token 只交付 7 个任务原子中 1 个的会话,与交付 6 个的会话,读起来完全不同。

4. 对照统计已交付与已要求

将任务集合与已交付集合交叉连接:

  • SHIPPED(已交付)——有已验证产物证据的任务原子
  • PARTIAL(部分)——有尝试证据、结果不完整
  • UNSHIPPED(未交付)——完全没有产物证据
  • UNTASKED-SHIPPED(未要求但已交付)——没有来源任务的产物(范围增加;标记但不谴责)

5. 分类缺失内容

对每个 PARTIAL 和 UNSHIPPED 原子进行分类:

  • Gap(缺口)——该条目在某个持久位置有记录(IRF 行、计划、TODO、开放 PR)但未完成。补救:完成或重新路由已有的记录。
  • Vacuum(真空)——该条目在任何持久位置都不存在;如果本次审计没有点名它,它就会消失。补救:在本次审计中为它建档(IRF 行、计划或登记项),然后记录建档 ID。

本次审计点名但未建档的真空仍然是真空。只有当每个真空都有了持久的归属,审计才算完成。

6. 输出会话治理索引

组装报告,包含以下章节:

  1. Identity(身份)——会话 ID、智能体、范围、时长
  2. Bibliography(书目)——已验证产物表(步骤 2)
  3. Energy(能耗)——工具使用计数、Token 估算、子智能体归属
  4. Tally(统计)——已交付/部分/未交付/未要求已交付计数 + 逐原子表
  5. Gaps(缺口)——每个缺口附其已有的持久记录
  6. Vacuums(真空)——每个真空附本次审计中建档的持久归属
  7. Verdict(裁决)——一段话:会话是否做到了它声称做到的?

将索引路由到会话的治理归档位置(例如 docs/evaluation/ 或会话档案),提交它,并在收尾记录中引用它。

反模式

  • 信任转录自己的摘要。 会话会过度报告完成度;始终重新验证。
  • 数提示而不是数祈使句。 一个密集的提示可能包含十个任务原子;统计前先分解。
  • 只把索引归档在本地。 未提交的审计是未完成的工作,不是已完成的审计。
  • 把未要求但已交付的工作当作免费。 范围增加消耗了本可给任务原子的能耗;暴露这个权衡。

微示例

被要求:“修复 CI 矩阵并推送”(T-01、T-02)。转录显示对 .github/workflows/ci.yml 的一次编辑(A-01,经 git show abc1234 验证)和一次没有远端证据的推送声明(A-02,git branch -r --contains 为空 → UNVERIFIED)。统计:T-01 SHIPPED,T-02 UNSHIPPED。分类:如果推送失败被记录在交接文档中,则 T-02 是 Gap;如果没有任何持久内容提到它,则是 Vacuum——此时建档 IRF-OPS-NNN:现在将 abc1234 推送到 origin 并记录该 ID 到 §6。

使用方式

该技能的安装命令、调用语法与运行环境等具体信息,资料中暂未提供。

适用场景与限制

适用于需要对 AI 会话进行治理审计、可问责记录与缺失项追踪的场景。资料显示其产出为结构化的会话治理索引并需提交到治理归档位置。关于平台支持、收费与价格、效果保证等方面的信息,资料中暂未提供。