62 lines
4.9 KiB
Markdown
62 lines
4.9 KiB
Markdown
# 复核群:在 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`;没配时群里回「确认 / 取消」兜底。
|
||
- 自动拉群会拉工单创建人,不只是角色成员——批量对存量单开群前要知道会把这些人都拉进来。
|