Skip to content

Commit 137eb00

Browse files
docs(pm,agents): three rules-layer lines catch up with the charter rulings (#18051)
Fixes #18019 Three governed lines outside the charter rules-layer PR's declared file surface still carried pre-ruling text after `9489e2c0` (rules layer) and `c185d087` (references) landed. Each now states the rule that governs it — one commit per file, each quoting its ruling verbatim and untranslated. | file | was | now | budget | |---|---|---|---| | `.claude/agents/os-dev.md` :50 | 先搜再立 — the filer scans open issues before filing | 立卡者不查重, 3–5 keywords on the card, never a board pull | 403/403 lines, 115 B (cap 120) | | `.claude/skills/pm-dispatch/SKILL.md` :106 | 跨车道移交 listed as a fourth release cause | three causes, 改路由 qualified 限未派发, 在飞卡跟到 MERGED | 812/812 lines, row 235 B | | same file :113 | 跨域 PR 指定车道、改路由, unqualified | 定车道与改路由限未派发卡 | row 269 B; widest row unchanged at 342 B (L244) | | `.claude/skills/pm-dispatch/references/lanes/ui.md` :25 | draft until a human merges, 不留批准 | draft until an authorized approval, then the owning seat lands it; the seat never approves | 38/38 lines, 118 B (cap 120) | `check:pm-skill-ratchet` green with every touched ceiling still at headroom 0 and no ceiling moved; SKILL.md frame block L733-754 md5 `3327d02c56f8a0eca88569dad2270f32` byte-unchanged. ## Executable criterion — measured `origin/main` 226970b to HEAD `git grep -c` per file: 先搜再立 in `os-dev.md` 1 to 0 · 跨车道移交 in `SKILL.md` 1 to 0 · 停在 draft 等人合 in `lanes/ui.md` 1 to 0. Lit controls on neighbouring surviving phrases, same greps, same two refs: `noted, not filed` 3 to 3 · 离手恒走释放 1 to 1 · 异议评论写明所求 1 to 1 · 未命中的 PR 按同节走合并队列落地 1 to 1. ## Gates `node scripts/pm/dispatch-gates.mjs --commands --repo objectstack-ai/objectstack` at HEAD `ac73575c` derived 18 families; all 18 ran in the foreground with the exit code captured before any pipe, all exit 0; `--ran` reconciles 18 derived / 18 run / 0 NOT-MEASURED / 0 UNRUN. `check:doc-formula-expressions` first answered exit 3 PREREQUISITE NOT MET (unbuilt workspace package, nothing measured) and was re-run to exit 0 after `turbo run build --filter=@objectstack/formula --filter=@objectstack/lint`. Repo-wide `pnpm lint` is not owed here and can produce no verdict on this diff: eslint's own config supplies no configuration for `.md`, and `--format json` over the three files reports 3 files, 0 errors, 3 warnings, each of them `File ignored because no matching configuration was supplied`. `skip-changeset` applies — `.claude/` publishes nothing from any released package. ## Premise checks P1, P2 and P3 confirmed on `origin/main` 226970b. P4 confirmed: all 12 open PRs were fetched into a private ref namespace and diffed against their own merge-base — none touches these files. P5 measured NO: `references/core-rules.md` mirrors none of the three pre-ruling lines; it already carries the post-ruling statements at :8, :51 and :123, so it is not in this diff. ## Acceptance notes Noted, not filed: `os-dev.md` :53, :54 and :58 still describe the dedupe channel the filer no longer uses (the `search_issues` fallback on 403, the control-word rule, 那一次查重). Same residue class as :50, but outside this card's declared one-line surface and the file's 403/403 ceiling. Carrier: the seat that owns the charter-revision family. ## 维护者速读(草稿) **改了什么** — 三个文件各改一处(SKILL.md 是两行表格行),把还写着旧规矩的句子换成已经落地的规矩:立卡人只在卡面附查重词、不再自己查重;在飞的卡不跨车道移交,改路由只对未派发的卡;受管面 PR 停在 draft 等的是「授权批准」,批准到手后由认领席自己 ready 加入队落地,席位仍然永不批准。 **为什么改** — 这三行落在章程改版 PR 的文件面之外,规则合入后它们就和已生效的规则直接打架。留着,下一个读到的人会照旧规矩办事。 **风险与代价(含回滚)** — 纯指令文本,没有运行时影响。三个文件都卡在行数上限,改动是等行替换,净增 0 行,棘轮一个都没抬。回滚就是 revert 这三个 commit,彼此独立、互不依赖。 **席位意见** — **你要做的** — 受管面,PR 留 draft 等你。请确认第三条的措辞:拿到授权批准后由认领席自己落地,是不是你要的形态? --- _Generated by [Claude Code](https://claude.ai/code/session_01DAcomhvR9kKizeYgg89Vo8)_ --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent fb29f62 commit 137eb00

3 files changed

Lines changed: 4 additions & 4 deletions

File tree

‎.claude/agents/os-dev.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ model: opus
4747
- 其余 ⛔ 不立卡:观察、死代码、未演练漂移、抛光、风格、文档 nit、命名。
4848
- 它们进 PR `## Acceptance notes`,报告 `out_of_scope_findings` 记 `noted, not filed: …`,席位 ACCEPT 读。
4949
- 写 `noted, not filed` 前先答哪一个 PR 或人会碰到这个文件;答不出就写明「承接者:无」。
50-
- 先搜再立:关键词 + 文件路径扫 open issues;并行 dev 同一小时立的卡只有这一搜能看见。
50+
- 立卡者不查重,只在卡面附 3–5 个查重词;查重归分诊席,⛔ 不扫 open issues、不拉板。
5151
- 通道先探后选:同容器先测一条 repo-scoped REST 读;通 ⇒ 走 REST 列表端点 + 本地 grep。
5252
- 通道对照表见 `.claude/skills/pm-dispatch/references/rest-channel.md`,其 ✓ 按座位实测。
5353
- 403 ⇒ 改用一次定向 MCP `search_issues`,并在报告申报换道。

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -103,14 +103,14 @@ PM 的工作是循环:选卡 → 认领 → 派发 → 收集 → 复核 → 报
103103
| issue 上的信号 | 含义 |
104104
|---|---|
105105
| open + 队列标签 + 无 assignee | 可派发(同卡带 `pm:retriage` 的除外);`pm:queue` 卡恒无 assignee,有即半态 |
106-
| assignee 已设 | 已认领/在飞,不是你的就永不碰;离手恒走释放 —— 四因 = 改路由、前提证伪、弃飞无接管、跨车道移交,去向 = 新标签态或车道;⛔ 不静默摘 assignee |
106+
| assignee 已设 | 已认领/在飞,不是你的就永不碰;离手恒走释放 —— 三因 = 改路由(限未派发)、前提证伪、弃飞无接管,去向 = 新标签态或车道;在飞卡跟到 MERGED,⛔ 不静默摘 assignee |
107107
| `pm:dispatched` | 已派发(派发评论记轮次),恒带 assignee;与摘 `pm:queue` 同一次标签写入成对落地 |
108108
| `needs-user-decision` | 决定待做:永不派发、除代裁通道外永不代答;维护者的收件箱 |
109109
| `pm:on-hold` | 决定已做且答案是暂不做:不派发不催;仅当带机器可读 `Restart-when:` 行才合法 |
110110
| `pm:blocked` + 正文行 `Blocked-by: #N` | 等上游:选择期跳过,#N 关闭时由解锁扫描放回;工已完、PR 被外部门禁卡住的同用本态 |
111111
| `pm:awaiting-maintainer` | 决定已做,只剩一次 GitHub 之外的人工动作:不派发不催;与其它 pm 状态标签互斥;入态恒带行首 `Maintainer-action:` 行(细则见 `references/state-machine.md`),无行即半态 |
112112
| `pm:blocking` | 有 open 下游依赖者(自 `Blocked-by:` 索引推导的缓存,⛔ 不手工挂);进选择全序 |
113-
| `pm:retriage` | 向分诊提问(改判、跨域 PR 指定车道、改路由、拆卡、裁 dev 报告留下的分叉),异议评论写明所求;与现行 `pm:*` 并存、⛔ 不摘原标;带本标签的 `pm:queue` 卡跳过派发 |
113+
| `pm:retriage` | 向分诊提问(改判、跨域 PR 指定车道、改路由、拆卡、裁 dev 报告留下的分叉),定车道与改路由限未派发卡,异议评论写明所求;与现行 `pm:*` 并存、⛔ 不摘原标;带本标签的 `pm:queue` 卡跳过派发 |
114114
| `finding` | 立卡三类内待首次定级,定级即离标;三类外关 not planned;不占队列不进收件箱 |
115115
| `target:<major>` | 发版阻塞:每个 backlog 恰好一个生产者 |
116116
| `pm:epic`(父单或 sub-issue) | 已由 epic PM 保留;其它 PM 永不取;⛔ 永不与 `pm:queue` 同挂 |

‎.claude/skills/pm-dispatch/references/lanes/ui.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222
- 凡触 `packages/spec` 一律转 `domain:spec` 座位,见 SKILL.md 〈多仓协调〉。
2323
- `scripts/pm/**` 单写手恒在 objectstack 侧 ⇒ 本席的工具需求走上游卡带 `Blocked-by:` 回链。
2424
- 受管面五项含仓根发布 `skills/**`,清单、判据与禁令见 objectui AGENTS.md §9 受管面段。
25-
- ⇒ 命中即整 PR 停在 draft 等人合,⛔ 不 ready、不入队、不 auto-merge、不自合、不留批准。
25+
- ⇒ 命中即停 draft;⛔ 未获授权批准不 ready 不入队不自合、永不批准,获批后认领席落地。
2626
- 未命中的 PR 按同节走合并队列落地;changeset 与版本纪律见 objectui AGENTS.md §9。
2727
- 半状态巡查在本仓有载体:定时 workflow 与 sweeper 皆在,自 objectstack 移植。
2828
- 锚 issue 未配置 ⇒ 写锚步骤 skip,发现只落 run summary,绿不等于已交付读锚腿。

0 commit comments

Comments
 (0)