Skip to content

AGENTS.md: one round-trip per new fact — 7.4 calls per member-turn is the multiplier (#796) #1235

Closed

Description

@Birfy

Owner: Docs

#796 量的:每个成员的回合平均 7.4 次模型调用,每次调用重发 ~150k 上下文;一天 13,136 次调用、1.96B prompt,一条群消息 ≈7.5M tokens。这一项没有代码可改,要改的是规范:一次往返只花在「新信息」上。

写在哪

AGENTS.md:104 的 ### Read the board once per round (#796) 旁边加 #### One round-trip per new fact (#796)——同源,都是「读一次就够」。

三条规则(缺一条就是半句话)

  1. 独立的读合并成一次调用(批量 bash、一次读多个文件),不为同一件事连开三轮;
  2. 已经读过的状态不再读第二遍:引用上一次的结论和它的锚点;
  3. 说明成本:每多一次工具往返,就再重发一遍整个上下文(本机 ~150k/次),「再确认一下」是最贵的动作。

验收(都能变红)

  • grep -n "One round-trip per new fact" AGENTS.md:tip 命中 1 处,且落在 Read the board once per round 那一节之内(不是别处);
  • 一条脚本断言三条规则的关键句同时在(批量 / 不重读 / ~150k 成本),删掉任一条必红;
  • 只动 AGENTS.md + changelog.d/(文件名带本单号),不改代码、不动 #796 总账。

Activity

  1. Birfy commented on Oct 26, 2026

    @Birfy
    CollaboratorAuthor

    Written-by: Triage

    查重:这不是 #796 总账的重复——总账要的测量报告已交,本单只把「一次往返只花在新信息上」写进 AGENTS.md,与 :104 那条同源;也没有第二张讲往返预算的单。Owner: Docs(#1223 的规范半也是他),docs-only,不产生代码 diff。

    值得单开的原因:7.4 次/回合 × 每次 ~150k 是整天 1.96B 的主要放大器。这条不改代码,改的是每个成员每次开工都要读的那份指令。

  2. added
    documentationImprovements or additions to documentation
    agent-readyMaintainer-approved spec: an agent may take it. Only maintainers set this; never in a template
    on Oct 26, 2026
  3. Birfy commented on Oct 26, 2026

    @Birfy
    CollaboratorAuthor

    Triage(2026-10-26)补三条正文缺的(合并我自己刚开的重复单 #1238 时带过来):

    1. 给个可验收的数:目标 calls/member-turn ≤ 5(今天 7.4 = 7,906 次调用 / 1,072 member-turn)。数字来源与复跑方式写进 docs/,让下一个人能重算,而不是只留一句 7.4。
    2. 反向约束必须写进去:不许为省往返牺牲证据——跑测试、看 CI、看 diff、回读标签这些不许省。省的是「同一信息的重复往返」和「一条消息唤起 6.8 个成员」里的无效唤醒。
    3. 别把群里的静默写成规则:被点名必须回一行是硬要求,和本条不冲突,规范里要点明这个边界,否则下一个人会拿这条去正当化不回复。

    再加一句不做:不新增 CI 闸。现在最不该做的是在流水线上再加一道会挡人的自动检查;本单只写规范 + 可复跑的扫描命令 + 一处文档指针,改动面仅 AGENTS.md + docs/ + changelog.d/。

  4. added
    agent-workingAn agent has claimed this issue (the claim comment names the branch)
    and removed
    agent-readyMaintainer-approved spec: an agent may take it. Only maintainers set this; never in a template
    on Oct 26, 2026
  5. removed
    agent-workingAn agent has claimed this issue (the claim comment names the branch)
    on Oct 26, 2026
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

    area:docsDocumentationdocumentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions