Files
streamline/docs/review-group.md
T
2026-11-16 17:26:44 -08:00

4.9 KiB
Raw Blame History

复核群:在 Meego 缺陷群里推进一张 bug

机器人私信是单点提醒,催不动人。Meego 缺陷群里本来就有报告人(QA)、经办人(RD)和工单创建人; 把 Streamline 机器人也拉进去,每个流转节点都发生在一个有别人看着的地方,催办才有推动力。

代码:shared/src/review_group.ts(纯逻辑)、control-server/src/review_group.ts(IO)。

分两步上线(2026-11-09 定)

第一步:只读(已上线) 第二步:前台助理(待做)
群里看得到 状态卡、「轮到谁」播报、超时催办 同左
@机器人 「状态」:现在在哪、轮到谁、最近 5 次流转、面板 / MR / Meego 链接;其它话 → 说明去面板和 Meego 操作 任意自然语言:答疑、收意见、推断要不要打回
写操作 无 推断出的动作回确认卡,报告人 / 经办人 / 管理员确认后执行
模型 不用 执行节点上的 Asking 会话(控制面不需要模型 token)

第一步怎么工作

  1. 开群:项目在批次设置里打开「复核群」(默认关,只有管理员能改)后,单子第一次要发通知时:

    • 读单上的「拉群方式选择」(group_type:auto / bind / disabled);
    • 不拉群的写成 "auto"(必须是字符串),Meego 随即建群,拉进创建人 + 报告人 + 经办人;
    • POST /open_api/:project/work_item/:id/bot_join_chat 把 Streamline 机器人拉进群;
    • 群号加进任务的 watchers:之后状态卡、复核卡补全、漏发补发都自动发进群。

    托管中(还没移交经办人)和评估集的单不开群。三个 Meego 接口 2026-11-09 在生产插件上实测过, 插件 token 就够。管理员可用 POST /api/tasks/:id/review-group 给单张单开群(试点用,不看项目开关)。

  2. 播报:状态卡发完,@ 当前该动手的人,说清楚在面板 / Meego 上要做什么 (待复核 → RD;待 QA 验收 → QA;QA 关单但 MR 未合 → RD;复现不了 → RD,QA 先验收的项目里是 QA)。

  3. 催办:同一段等待满 24 小时再 @ 一次,之后每天一次,最多 3 次;只在北京时间工作日 10–19 点。

开关:REVIEW_GROUP_DISABLED=1 整块停用;REVIEW_GROUP_ACTIONS=1 打开群里的写操作(第二步用)。

第二步:类比 Asking Mode

面板的「质询」(Asking)已经解决了「控制面没有模型 token 也能用模型」:会话跑在执行过这张单的卫星上 (那台节点有工作区、执行日志、FixReport、代码 checkout),控制面只转发 (/api/tasks/:id/asking/send|stream|history → satPath.asking.*)。复核群的前台照搬这条路:

  1. 群里 @机器人 的话(含截图、被引用的消息)→ 控制面 → 这张单执行节点上的 Asking 会话 send, from 带发言人(名字、邮箱、在这张单上的角色)。截图先走 asking/upload。 和面板「质询」是同一个会话:群里问过的,面板上点开就能接着问,上下文不分叉。
  2. 群来源的轮次在 preamble 里约定输出:先给群里看的回答(短,长了截断并附面板链接),末尾附一段 结构化决策,例如 {"decision":"answer" | "propose_rework" | "propose_note", "reworkText": "..."}。
  3. 控制面读 history 等这一轮结束,把回答回复进群;决策是 propose_* 时回确认卡(第一步里已写好的 confirmCard / rejectBugReview / 写 Meego 评论,就是这一层的执行器)。模型只提议,人点了才执行; 流转账本记点确认的人。
  4. 约束:
    • 群来源永远不进 code-mode(不碰 checkout 锁、不改代码);
    • 状态门和面板质询一致:manual_review / fix_succeeded / unreproducible;其它状态退回第一步的只读回复;
    • 执行节点离线 / 会话报错 → 退回只读回复,不让群里干等;
    • 打回原因的真值仍在 Meego 单上:确认打回时原样写成单上评论(2026-11-05 定的规矩);
    • 真值只认执行结果(docs/rsi.md 的底线):前台推断「该打回」不算质量信号,人确认的打回才算。
  5. 用量:这些轮次计入卫星的 Asking 用量(claude_usage_source 按首条 prompt 归类), 上线前要给群来源单独一个来源标签,方便看成本。

已知限制

  • Streamline 应用没有 im:chat / im:chat.members 权限:机器人不能拉人进群,也读不到成员列表。 拉人只能靠 Meego(自动拉群、join-chat)或群里的真人。想把 TL / 治理负责人拉进群增加围观压力,要先申请权限。
  • 卡片按钮要在飞书开发者后台把「回调」配成长连接、订阅 card.action.trigger;没配时群里回「确认 / 取消」兜底。
  • 自动拉群会拉工单创建人,不只是角色成员——批量对存量单开群前要知道会把这些人都拉进来。