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

62 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 复核群:在 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`;没配时群里回「确认 / 取消」兜底。
- 自动拉群会拉工单创建人,不只是角色成员——批量对存量单开群前要知道会把这些人都拉进来。