SuperAPI AI 工具集

agent-output-reconciler

智能体与模型

查看项目

更新于 10-16 07:02

技能介绍

用途

agent-output-reconciler 用于多智能体协作场景:当多个智能体完成各自任务后,需要在一项验收决定之前,把它们的产出核对、比对并整合成一份基于证据的报告。它回答的是“实际发生了什么、哪些冲突仍未解决”,而不是替人做验收判断。

该技能明确不负责:验收工作、合并变更、重试任务、写入规范记忆。

主要能力

  • 校验计划与检查点:若计划或 TaskCheckpoint 不可读,则停止并报告阻塞,不推断缺失的策略值。
  • 清点全部计划任务:把 null、缺失、取消、拒绝、降级、失败等结果保留为彼此不同的状态。
  • 过滤不可用载荷:在综合之前过滤,同时保留被过滤内容及原因的记录;不因可选的结构化输出步骤失败,就把已完成的文字结果变成 null。
  • 范围比对:将实际变更文件与每个任务声明的范围比较,把有正当理由的传递性变更与无法解释的漂移分开记录。
  • 证据核验:依据证据引用核实所声称的测试与产物;没有证据的结果即使文字写着“成功”也仍属未验证。
  • 冲突识别:发现文件碰撞、不兼容假设、相互矛盾的发现、依赖顺序违规以及未解决风险。
  • 生成报告:按 references/reconciliation_template.md 组织核对报告,并交给 agent-acceptance-gate;不把核对建议转成验收决定。

使用方式

输入包括:

  • 当前计划及其任务 ID、角色、范围、依赖和成功标准;
  • 每个任务包、结果摘要、结构化结果和原始日志路径;
  • 相关的 TaskCheckpoint 与最新 PolicyDecision;
  • 仓库 diff 与测试证据。

当前计划使用与供应商无关的角色:primary-agent、delegated-executor、reviewer、synthesizer。历史供应商字段仅可为迁移而解析,不得影响当前路由。

工作流依次为:校验计划与检查点;清点每个计划任务;过滤不可用载荷;比对实际变更文件与声明范围;依据证据引用核验测试与产物;识别冲突与风险;按模板撰写核对报告;交给 agent-acceptance-gate。

任务内容证据审查要求把每个结果绑定到当前任务、运行/尝试、基线和独立观察到的候选对象;过期或错误任务的证据保留为未验证。在归因差异前,要考虑已有的脏状态和并行写入者。未变更的结果需要契约许可、理由和当前标准证据;仅凭修改时间无法证明或否定成功。内容一致并不等于语义正确,也不授权传递性范围扩张。

输出契约

报告必须包含:

  • 计划与策略引用;
  • 逐任务的角色、状态、证据引用、变更文件、测试和风险;
  • 被过滤或缺失的结果记录;
  • 有共同证据支持的一致结论;
  • 矛盾与文件冲突;
  • 带明确阻塞项的推荐下一步行动。

默认把协调输出写入配置的暂存区;仅当项目明确要求交付产物或验收记录时,才把报告提升到仓库拥有的证据路径。暂存输出不隐含可提交性。

策略与上下文

所有数值限制来自 agent-collab policy evaluate 评估的规范策略,不把默认预算复制进计划或本技能。在一次核对周期之后、任何新生成之前,应重新评估策略。遵守决定的适用范围:v2 的 action stop 禁止重复该动作,但不禁止安全的主智能体诊断;goal stop 保留硬门禁。继续之前先持久化检查点。符合条件的 v2 切片在同一目标下自动推进,而 v1 保留其原有停止行为。

安全规则

  • 不对事实真伪投票;优先采用已验证证据并暴露分歧。
  • 不用乐观综合掩盖失败或缺失的结果。
  • 当路径和有界摘录足够时,不粘贴原始日志。
  • 不修改源文件、规范记忆、历史或人类决定。
  • 不提交、不合并、不推送、不批准本轮。

适用场景与限制

适用于多智能体并行或分派任务后、验收前的证据核对与冲突梳理。限制在于:它不做出验收决定,不合并或提交变更,不重试任务,不写入规范记忆;缺少可读计划或检查点时会直接报告阻塞;未提供证据的结果只能标记为未验证。关于具体收费、价格、平台支持范围等信息,资料暂未提供。