Skip to content

Commit d098bd3

Browse files
qq9340100claude
andauthored
docs(pm-dispatch): sweep 打包晋级条款(#6243 试点定稿)+ mode:cloud 交付通道二修 (#6341)
* docs(pm-dispatch): sweep 打包晋级条款(#6243 试点定稿)+ mode:cloud 交付通道二修(自开 PR + 订阅唤醒) 发现分诊轮新增 sweep 打包晋级:同类判据、逐项清单、零 rider 自证、范围外 照旧单开、成员单防双派 —— 五条均出自 #6243/PR #6288 试点实测。 mode:cloud 第 3 课改写:create_session 卡实测持有 GitHub API 工具(三例), 正道改为 dev 自开 draft PR + 终报 issue 评论 + PM 挂 subscribe_pr_activity 秒级唤醒;降级通道收窄到 trigger 拉起的会话;巡检退为兜底心跳。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011M7UwH25Unfi73UHim7ajY * chore: re-run CI after skip-changeset label (gate reads live labels on rerun) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011M7UwH25Unfi73UHim7ajY --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent 81a4a67 commit d098bd3

1 file changed

Lines changed: 43 additions & 9 deletions

File tree

.claude/skills/pm-dispatch/SKILL.md

Lines changed: 43 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -818,6 +818,24 @@ Prime Directive #10 是一个强力生产者,而循环原本只有「修掉」
818818
范围 —— 已排队父单的 sub-issue 会自动成为派发候选(step 1),把仅有依赖
819819
关系的发现挂进去等于让未分诊的东西静默入池;那种情况独立立单 +
820820
`Blocked-by:`(cloud#1045/#1046 之于 cloud#1050 即此形)。
821+
- **sweep 打包晋级**(试点 #6243 / PR #6288 一轮跑顺后定稿,维护者
822+
2026-08-07 批准):晋级一批**同类**发现时,可以打包成**一张 sweep 卡**
823+
代替逐张入队 —— 一次认领、一个 PR、N 条 `Fixes`、逐项清单评审,把每单的
824+
认领/PR/CI/验收固定开销摊薄到 1/N。这是「顺手修」的制度化替身:省同一笔
825+
固定开销,但评审完整性不打折。打包判据与纪律,五条都是试点实测过的:
826+
1. **同类才打包**:全部命中同一判据(试点即「description 面在说谎或漂移」,
827+
全部校验不变量卡);不同性质的卡打包=一张 PR 里混多个评审面,禁止;
828+
2. **逐项清单是 PR 正文的必备件**:每项一行 落点 | before | after,评审
829+
按行核,不按 diff 顺序读;
830+
3. **N 项之外零改动**,且 PR 自证(`git diff --stat` 文件数与清单一一
831+
对应)—— 这是 sweep 与 rider 的分界线;
832+
4. **范围外发现照旧单开**(PD #10 不因打包而豁免;#6287 之于 #6288
833+
此形);
834+
5. **卡片本身是认领对象**:sweep 卡入队、被认领,成员单保持 `pm:queue`
835+
标签但**不再是可派发候选**(选择期按 sweep 卡的成员清单排除,防双派;
836+
PR 合并时 N 条 `Fixes` 齐关)。
837+
适用面注记:`domain:spec-surface` 车道的默认运行模式即 sweep-first
838+
(见「`spec` 一分为二」);其它车道按发现批次的同类度自行判断。
821839

822840
#### 发版板(`target:<major>` —— 发版视角的常设轴,维护者 2026-08-06 拍板)
823841

@@ -1357,15 +1375,31 @@ to `mode:subagent`).
13571375
处停摆,而 PM 只能靠 poke 唤醒。条款原文形:⛔ 不为提问/中期汇报结束回合;
13581376
开放选择按裁决与三轴自裁记入终报 open_questions;合法回合终点只有
13591377
(a) 推送完成 + 终报 JSON 作为最后一条消息,或 (b) 硬阻塞详报。
1360-
3. **交付通道写明降级路径。** 云会话通常没有 GitHub API 工具(连接器不随
1361-
create_session/trigger 传递),派发词写明:开 PR / 发评论失败 ⛔ 不视为
1362-
阻塞 —— 推送 outcome branch + 终报作最后一条会话消息,**PM 代开 draft
1363-
PR、代转录报告**到 issue(权限面不因此放大)。
1364-
1365-
**监控与转向**:`get_session` 读实时状态(status / model / token 用量;
1366-
IDLE + 分支未推送 = 停摆待 poke);投递消息用**绑定会话的 poke 触发器**
1367-
(`create_trigger``persistent_session_id` + `fire_trigger` + 用后即
1368-
`delete_trigger`)。收报:巡检主动读会话终报与分支推送,⛔ 不等推送通知。
1378+
3. **交付通道:自开 PR + 订阅唤醒是正道,降级通道只属于 trigger 流。**
1379+
初版条款以为云会话一律没有 GitHub API 工具 —— 对 `create_session` 卡是
1380+
**过度保守的误判**(2026-08-07 下午三例实测推翻:#5599 会话自发 issue
1381+
评论、#5775 会话自立两张 issue、#6243 会话自开 PR #6288),没有工具的只是
1382+
**trigger 拉起**的会话(与第 1 课的 403 同源)。据此分流:
1383+
- **create_session 卡(常态)**:派发词要求 dev **自开 draft PR**
1384+
(`Fixes #<n>`,正文含验证记录)并把终报以 **issue 评论**
1385+
(`<!-- os-dev-report -->`)交付;PM 在派发后立即对该 PR(或预期分支的
1386+
PR)挂 `subscribe_pr_activity` —— dev 的完成动作即 webhook,通知延迟从
1387+
「≤巡检间隔」降到秒级。**例外仍归 PM 代办**:会话未 attach 的姊妹仓
1388+
(源仓之外)依旧够不着 —— 跨仓跟进卡由 PM 代立(#5775 的 objectui
1389+
跟进卡即此形)。
1390+
- **trigger 拉起的会话(定时/重复型)**:维持降级通道 —— 推送 outcome
1391+
branch + 终报走报告 ref(空提交信息)或最后一条会话消息,PM 代开
1392+
draft PR、代转录(权限面不因此放大)。附一条实测:报告 ref 用完后
1393+
PM 侧 `push --delete` 会被 git 代理 403(推送授权不含删 ref),清理
1394+
要走有权限的通道或留给维护者。
1395+
1396+
**监控与转向**:事件面交给 PR 订阅(上条),`get_session` 读实时状态
1397+
(status / model / `post_turn_summary`;IDLE + 分支未推送 = 停摆待 poke);
1398+
投递消息用**绑定会话的 poke 触发器**(`create_trigger`
1399+
`persistent_session_id` + `fire_trigger` + 用后即 `delete_trigger`)。巡检
1400+
从主通知通道退为**兜底心跳**:webhook 不保证送达(CI success/新推送/踢队
1401+
可能缺席),定时器仍要挂,但频率可放宽,且每轮先核订阅已覆盖哪些面、只补
1402+
盲区(会话停摆、未开 PR 的分支、姊妹仓动静)。
13691403

13701404
#### 座位 Routine 化(PM 侧的运行形态,#5472 第 5 点)
13711405

0 commit comments

Comments
 (0)