4.9 KiB
复核群:在 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) |
第一步怎么工作
-
开群:项目在批次设置里打开「复核群」(默认关,只有管理员能改)后,单子第一次要发通知时:
- 读单上的「拉群方式选择」(
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给单张单开群(试点用,不看项目开关)。 - 读单上的「拉群方式选择」(
-
播报:状态卡发完,@ 当前该动手的人,说清楚在面板 / Meego 上要做什么 (待复核 → RD;待 QA 验收 → QA;QA 关单但 MR 未合 → RD;复现不了 → RD,QA 先验收的项目里是 QA)。
-
催办:同一段等待满 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.*)。复核群的前台照搬这条路:
- 群里 @机器人 的话(含截图、被引用的消息)→ 控制面 → 这张单执行节点上的 Asking 会话
send,from带发言人(名字、邮箱、在这张单上的角色)。截图先走asking/upload。 和面板「质询」是同一个会话:群里问过的,面板上点开就能接着问,上下文不分叉。 - 群来源的轮次在 preamble 里约定输出:先给群里看的回答(短,长了截断并附面板链接),末尾附一段
结构化决策,例如
{"decision":"answer" | "propose_rework" | "propose_note", "reworkText": "..."}。 - 控制面读
history等这一轮结束,把回答回复进群;决策是propose_*时回确认卡(第一步里已写好的confirmCard/rejectBugReview/ 写 Meego 评论,就是这一层的执行器)。模型只提议,人点了才执行; 流转账本记点确认的人。 - 约束:
- 群来源永远不进 code-mode(不碰 checkout 锁、不改代码);
- 状态门和面板质询一致:
manual_review/fix_succeeded/unreproducible;其它状态退回第一步的只读回复; - 执行节点离线 / 会话报错 → 退回只读回复,不让群里干等;
- 打回原因的真值仍在 Meego 单上:确认打回时原样写成单上评论(2026-11-05 定的规矩);
- 真值只认执行结果(
docs/rsi.md的底线):前台推断「该打回」不算质量信号,人确认的打回才算。
- 用量:这些轮次计入卫星的 Asking 用量(
claude_usage_source按首条 prompt 归类), 上线前要给群来源单独一个来源标签,方便看成本。
已知限制
- Streamline 应用没有
im:chat/im:chat.members权限:机器人不能拉人进群,也读不到成员列表。 拉人只能靠 Meego(自动拉群、join-chat)或群里的真人。想把 TL / 治理负责人拉进群增加围观压力,要先申请权限。 - 卡片按钮要在飞书开发者后台把「回调」配成长连接、订阅
card.action.trigger;没配时群里回「确认 / 取消」兜底。 - 自动拉群会拉工单创建人,不只是角色成员——批量对存量单开群前要知道会把这些人都拉进来。