智能体交接契约核验工作流

智能体交接契约核验工作流

4个实用技能 · 4步完成 · 每一步都能单独使用

面向多智能体协作中的任务交接：将发送方的目标、约束、证据和未决问题整理成契约，逐条核验声明，检查接收方是否真正接受范围和约束，最后生成不自动继续执行的人工闸门；全程只处理脱敏 JSON，不连接外部系统。

4个可下载技能 · 每个技能可单独运行

4步自动化工作流

🔵 1 智能体交接契约整理

技能文件：agent-handoff-contract-normalizer

解决什么： 把任务目标、sender/receiver、约束、范围、附件引用、已完成步骤、未决问题、权限和副作用状态放进同一份契约，避免“我以为已经做完”的口头交接。

What you get: agent-handoff-contract.json、缺失字段、契约哈希和不执行外部动作的边界。

↓ 本步结果自动进入下一步

🟢 2 智能体交接声明核验

技能文件：agent-handoff-claim-verifier

解决什么： 将每条完成声明回指到 artifact_ref，并把 expected_state 与附件当前状态对照，识别“草稿已发送”“审批已完成”等不受证据支持的说法。

What you get: agent-handoff-claim-report.json、逐条支持结果、冲突/过期声明和 claim_hash。

↓ 本步结果自动进入下一步

🟠 3 智能体交接接收核验

技能文件： agent-handoff-acceptance-auditor

解决什么： 检查接收方身份、接收确认、继承约束、未决问题、幂等键和副作用状态，阻止接收方在没有明确范围时直接接着调用工具。

What you get: agent-handoff-acceptance-report.json、ACCEPT/REVIEW 状态、阻断原因和 acceptance_hash。

↓ 本步结果自动进入下一步

🟣 4 智能体交接继续执行闸门

技能文件：agent-handoff-continuation-gate

解决什么： 汇总契约、声明和接收方结果，把继续执行变成可审计的人工作业队列，而不是隐式放行。

What you get: agent-handoff-continuation-gate.json、blockers、review_queue、human_decision 和 continuation_allowed=false。

↓ 本步结果形成最终交付

实际示例

脱敏样例包含一个退款草稿，发送方声明“退款已经发送”，但附件状态仍是 DRAFT；另一个声明“已生成草稿”有证据支持。第二步会输出 CLAIM_CONFLICT/REVIEW；第三步因接收方未确认、约束未完整继承和未决问题未关闭而保持 REVIEW；第四步在 human_decision=PENDING 下输出 READY_FOR_HUMAN_REVIEW，并明确 continuation_allowed=false。该结果是本地测试事实，不代表任何真实客户成果。

适合谁

• 使用多个专用智能体串联研究、审批、客服或运营任务的平台团队

• 需要降低长链路上下文丢失、错误声明和隐式工具调用风险的工程团队

• 正在采用 handoff、human-in-the-loop 或 Agent Handoff Protocol 的安全、内审和交付团队

• 想先在本地脱敏导出上验证交接契约，再决定如何接入编排框架的负责人

买家只需提供

• 脱敏的 sender/receiver 交接 JSON、任务引用、目标、约束和范围

• 每个声明对应的 artifact_ref、状态、摘要和内容哈希

• 接收方确认、继承约束、未决问题、幂等键和人工决定规则

使用方式

1. 解压四个技能目录，使用 Python 3.10 或更高版本。

2. 先运行契约整理，再将契约和附件摘要交给声明核验；然后提交接收方确认，最后运行继续执行闸门。

3. 在测试环境检查冲突、blockers、human_decision 和 continuation_allowed，再由负责人决定是否在自己的编排系统中继续。

交付与验收

• 四个独立技能目录，含 _meta.json、agents/openai.yaml、SKILL.md、README.md、scripts 和脱敏 examples。

• 最小样例应识别至少 1 条证据冲突，接收方核验输出 REVIEW，最终输出 READY_FOR_HUMAN_REVIEW 和 continuation_allowed=false。

• 缺失契约字段、未回指证据、状态冲突、未确认约束、非幂等副作用和人工决定 PENDING 必须产生可定位结果。

• 不包含云端 handoff 接入、消息投递、工具调用、付款、退款、权限变更、自动重试或人工审批服务。

服务说明

本包是离线 JSON 交接契约与人工治理闸门工具，依赖 Python 标准库，不代表对 OpenAI、Microsoft、AHP 或任何云厂商 SDK 的认证或完整接入。公开讨论、官方文档和公开协议只用于需求和边界参考；本包未复制其代码、付费模板或私有流程。不会承诺零错误、绝对合规、自动放行或固定节省比例，也不绕过平台权限、审核和风控。