Agent Skills
返回列表
💻

交付证据闸门

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c188d95d/roy-evidence-gated-delivery 到你的 AI 助手中。

技能介绍

进度汇报的常见盲区

在工程交付中,一个隐蔽的陷阱是:Agent 报告任务完成,但实际只是本地生成了文件、测试脚本通过,或数据库里写了一条 published: true 记录。团队如果基于这类“假阳性”信号推进后续工作,往往会在真实环境验收时遭遇失败。

证据链与标准状态判决

为了消除这种信息差,交付证据闸门(Delivery Evidence Gate)引入了一套严格的证据分级与推断阻断机制。它要求 Agent 在汇报前,先拆解复合声明(如“已部署并开始赚钱”),将其还原为“代码部署”、“服务可访问”、“存在真实订单”等原子事实,并匹配对应的最低验收面。

为了让结论客观,该技能定义了严格的标准状态词汇:

  • proven:在指定验收面上已完成核验,证据有效。
  • local_only:仅本地产物成立,外部结果未核验。
  • needs_external_acceptance:依赖真实外部界面或回执。
  • stale:证据有效但超出允许的新鲜度。
  • contradicted:现有证据直接否定声明。
  • unknown:证据不足。

审计工作流

在具体执行时,Agent 会遵循以下工作流:

  1. 读取 SOURCE_OF_TRUTH.md 与验收说明,确立评估基准。
  2. 运行只读预检脚本,获取本地文件的大小、路径与修改时间。
  3. 针对“部署”、“同步”、“导出”等不同声明,要求提供公开 URL 回读、差异比对清单或结算回执作为最低验收面。
  4. 汇总输出结构化的审计报告,每条证据必须附带精确日期或可追溯标识。

适用边界与限制

该技能是一个只读审计工具,不修改被审计项目。它明确禁止在缺少外部回执时使用 proven 状态,拒绝因项目代码中出现 done、ready 等关键词就下定结论,也不会读取任何凭据、Cookie 或浏览器历史记录。用户明确要求修复时,才会进入单独的变更任务。

使用场景

  • 代码已合并,发布是否对外可读尚未确认,需要用公开 URL 回读判定 proven 还是 needs_external_acceptance。
  • 数据同步任务声称已完成,需要比对目标端回读与校验和,识别 stale 或 contradicted 状态。
  • 产品上线后 Agent 称已开始产生收入,需要分别核验订单、支付、结算三类证据再下结论。
  • 面对“已部署并跑通”这类复合声明,需要拆成原子声明逐条匹配最低验收面并输出审计报告。

适合人员

  • 独立开发者:需要区分本地跑通与生产环境真实可用,避免把文件存在当作已发布。
  • 交付负责人:要在验收发布单前核验外部回执,拒绝仅凭 done 关键词给出的完成结论。
  • Agent 应用工程师:需要给自建 Agent 加上证据闸门,约束其只读预检与状态判定流程。
  • 平台运维:需要在同步或导出任务结束后,按标准状态词汇输出带精确日期的审计报告。