Skip to content

[BUG] batching shape 将 wait_agent 等待及有依赖的多次派发误判为 single operation #893

Closed

Description

@T-Auto

现象

ops-ptc 的 shape 提醒把两种合理程序都确定性称为“spent a round trip on a single operation”:

  1. 仅等待 subagent 的 tools.wait_agent;
  2. 搜索结果决定后续读取路径的两次顺序派发。

本轮真实会话均收到该提醒。第二种不能预先把读取和搜索并发;第一种在没有独立工作时是合理依赖屏障。提醒不是工具执行失败,但会增加持久上下文并诱导不必要并行。

最小复现(实际运行纯函数,不是只读源码推断)

基线 033aba30;与当前缓存 origin/main 比较,相关分类器和测试未改。Node v24.18.0,临时副本完整复制两个 TypeScript 模块,仅把导入扩展名 .js 改为 .mts 以运行;未构建或覆盖 linked 主仓的 lib。纯函数 probe exit=0。

// sample A
// plan: wait for the verification agent
return await tools.wait_agent({ timeout_ms: 30000 })

// sample B(与 A 分开传给 analyzeProgram)
// plan: search; read the matching file
const hits = await tools.grep({ pattern: "needle" })
return await tools.read({ file_path: hits.matches[0].path })
样本 dispatchSites isWaiting violations.shape
wait_agent 1 false true
搜索→依赖结果读取 2 false true
job_output({wait:true}) 对照 1 true false
单 read 对照 1 false true

定位

src/ptc/batching-guidance.ts:

  • :84 WAITING 只认 wait: true 和 job_output(,漏掉 wait_agent。
  • :265 已统计 dispatchSites,但 :310 的 shape 谓词不检查是否只有一个调用站点。
  • :370 文案却确定性声称 single operation,与第二个样本的两个派发站点不符。

最小修复与验收

  1. 从已识别的工具调用站点认出 tools.wait_agent 与 tools["wait_agent"];不要靠注释/字符串里出现工具名来豁免。
  2. 对两个以上明确 dispatchSites,不再发“single operation”形状指控。静态信息不足以证明它们相互独立,不擅自要求并行。
  3. 上述两个反例无 shape 提醒;已有单 read 样本仍按原策略提醒。
  4. 保留 plan / bypass 各自判断:等待或多调用不能顺带豁免文件绕过/缺计划行。
  5. latch 优先级、合规重置、按 turn 重置、现有成功/失败返回值、权限与调用执行顺序全部不变。
  6. 补 dot/bracket 正反例、注释/字符串假调用反例,revert 即红;不增加依赖、工具、schema 或常驻教程,不以长提醒解释本可直接消除的误报。

去重与范围外

关联 #848 的根程序 shape 启发式,但不重做其批量设计;#865 P1-3 是 bypass 输出过滤与加载指引,#858 是配置丢引导,#868/#869 是 REPL 作用域,#866/#871 是 Native/SDK 契约,不覆盖这里的等待/多派发误报。

不要求关闭所有单调用提醒、不设新的全局条数上限、不改合规 re-arm 策略、不要求等待与其它有依赖的操作盲目并发。不引用本轮约3k token估算为实测收益。

Activity

  1. added 2 commits that reference this issue on Nov 13, 2026
    b2bd961
    d184019
  2. Thatgfsj commented on Nov 18, 2026

    @Thatgfsj
    Collaborator

    已独立建单跟踪:#999。以下保留原始复现说明,认领与进度请在新单进行。

    P8 · 验证等待、依赖派发和正常翻页的误报

    总计划 #978,所属工作流 #978。

    问题:shape 提醒依据程序结构。误把合法等待或依赖执行判成浪费一轮,会诱导模型改坏正确程序。

    前置条件:现有 #938,先在原 PR 核对覆盖再认领。

    从哪里读

    • src/ptc/batching-guidance.ts
    • test/batching-trigger.test.mjs

    认领前记录当前 main SHA。以上为优先检查的范围,需要扩大写域时先说明文件与原因。

    按顺序执行

    1. 输入三段程序文本:实际 wait_agent/job_output 等待、先 grep 后读命中、带 plan 的游标循环;保留各自的 dispatch 位置。
    2. 加入真正薄的单调用作正对照,再加入注释或字符串中仅出现 wait 名称的反例。
    3. 按类别锁状态验证违规→合规→再违规的顺序,记录每次是否提醒和类别。

    验收清单

    • 真实等待及多个依赖派发不出现 single-operation 指责;仅在字符串写 wait 不应伪装成等待。
    • 与批处理无关的 plan 或 bypass 分类仍按既有契约工作。

    范围边界与停手条件:勿更改宿主 repeat-tool-reminder;同文件与 P1/P2 串行合并。

    验证与交付

    先运行 npm run build;依赖 native worker 的测试先运行 npm run build:ptc。定向入口:node test/run.mjs batching-trigger。确认过滤器命中目标套件,记录实际 pass / skip / fail。

    认领模板:编号 / 当前 SHA / 目标文件 / 第一个失败样例。提交时贴修改前与修改后结果,以及撤掉改动后会失败的断言。已有 PR 请先在原讨论协作。行为及中英文文档同 PR。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions