Agent Skills
返回列表
🤖

AI 完成声明验收器

AI Agent 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md 的指示,将规范名为 @user_f274b691/auditing-completion-claims 的技能安装到当前 AI 助手。

技能介绍

问题:当「跑通了」被当成「完成了」

协作流里最常见的故障模式很隐蔽:Agent 说「环境好了,可以测了」,接收方直接开测,才发现端口下面是旧版本进程;或者看到 HTTP 200 就默认数据正确。本技能给每条完成报告定了基调:它只是一条声明(claim),不是结论。声明只在它恰好证明的那一层成立,对上层不负任何责任。把「进程在跑」等同于「正确程序在跑」、把「改了文件」等同于「运行行为已变」、把「本地可用」等同于「共享环境可用」,都是这个陷阱的典型形态。

工作原理:四问、证据分级与层级阶梯

收到任何完成报告时,先回答四个问题:到底完成了什么(范围,不是氛围)、证据是什么(产物、命令输出、trace,不是叙述)、哪些留白没做、下一步由谁负责(具名角色,不是「以后」)。四问答不齐的报告一律退回补证据,而不是接受。

  • 证据分级:E1 是读到的文件原文,E2 是当场跑出的命令结果,E3 只能标为「推测,未验证」,E4 等待外部确认,E5 是用户直接决策。红线:E3 不能写成 E1/E2,「没看到错误」不能写成「诊断返回零」。
  • 基座坐标:对 git 仓库、数据库、已部署服务等可变基座做 E2 断言时,必须一行内同时给出坐标和新鲜度(如 仅本地·未fetch)。陈旧快照的结论自动降级为「本地快照显示…,远端未核」——「我跑过命令」不等于验证了权威本体。
  • 先查再问:若声明在本会话触手可及(文件、git 状态、日志、ledger),先静默验证再带着结论回应,而不是反过来让用户补证据;触不到才退回四问。
  • 三分法与层级:报告拆成事实(带证据等级)、判断(从事实推导)、行动(带 owner)——判断没事实支撑就补事实,行动没 owner 就先指派。每条声明还要标明自己所在的层级:静态检查 → 本地运行 → 集成联调 → 共享环境冒烟 → 用户场景验收 → 生产就绪。通过第 N 层不代表第 N+1 层通过。

对执行者(子 Agent、委派会话)的回执,另有两道协议:越权必须披露,只有同时满足「可审计、纯增量、方向更保守、无跨边界、无现网影响」五条才可事后追认,否则回滚重派;模糊逐条摆进「⚠️ 需你知情」区,宁可多摆一条,不可静默消化。

适用边界

这套流程针对的是「完成声明」这类信息,不负责重做工作:审计永远指向声明而非人,一轮四问结束即收,防止无限递归;同线程已给过 E1/E2 的证据不重复索取,只审增量。它不替代真正的验证——用户可以 E5 接受风险,但未验残项必须先列清楚再走。对触不及的外部系统,正确做法是标 E4 等外部确认,而不是模拟出一份假的 E2。

使用场景

  • Agent 报「环境好了,可以测了」,先核对它通的是哪一层、证据是什么,再决定是否开测
  • 收到「测试通过,修复完成」的报告,定位结论落在层级阶梯的哪一步、共享环境是否仍留白
  • 给子 Agent 派完任务,回执显示它改了授权范围外的文件,判断越权能否事后追认
  • 写自己的修复总结时,标清证据等级、未验证的残留项和下一步负责人后再结束会话

适合人员

  • 把开发任务委派给 AI Agent 的工程师,需要按证据验收回执而非相信叙述
  • 把关上线质量的 QA 或技术负责人,需要定位 agent 的 done 声明证明了哪一层
  • 编写自动化脚本或编排 AI 会话的开发者,自己的产物要产出带证据分级的完成报告
  • 管理多个 AI 会话的协调者,需要对执行者回执做越权与模糊披露的审计