用途
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 保留其原有停止行为。
安全规则
- 不对事实真伪投票;优先采用已验证证据并暴露分歧。
- 不用乐观综合掩盖失败或缺失的结果。
- 当路径和有界摘录足够时,不粘贴原始日志。
- 不修改源文件、规范记忆、历史或人类决定。
- 不提交、不合并、不推送、不批准本轮。
适用场景与限制
适用于多智能体并行或分派任务后、验收前的证据核对与冲突梳理。限制在于:它不做出验收决定,不合并或提交变更,不重试任务,不写入规范记忆;缺少可读计划或检查点时会直接报告阻塞;未提供证据的结果只能标记为未验证。关于具体收费、价格、平台支持范围等信息,资料暂未提供。