Repository navigation
Commit 099a037
docs(pm-dispatch): write the ruled lane boundary rules (#31552)
domain:skills#2 · zhuangjianguo · session_01QsR2jT34CXs5fCn3BDirZw
<!-- claude-projects-attribution: {"github_login":"zhuangjianguo"} -->
_Requested by **Steedos** · [project
thread](https://claude.ai/code/project/chan_018ETKaNwMZCNRYD7D8Q9Ubb?thread=cmsg_018ETKaNwMZCNRYD7D8Q9UbbQt7DhTHo5f7X6VxoS3w9Q7)_
Fixes #31424
Clause-②: no
Metadata-protocol: none
## 维护者速读
- **改了什么:** 把已裁定的七条车道边界规则写进 pm-dispatch:文档页按所记录的包走车道;元数据协议改动拆成 spec
子卡;workflow 按路径归 devx;`examples/**` 测试基建有了定义;对外发布的 skills 改动拆成 skills
子卡;内部规则不搭产品 PR;devx 定位为 AI 员工流水线效率并列出六项度量。
- **为什么改:**
维护者已在本卡两条裁决记录(6722023475、6722123324)里同意,同一功能的代码与文档不再被拆到两条车道,spec 与
skills 的改动也有了固定去处。
- **风险与回滚:** 只改规则文本(5 个文件,+27/−24
行),不动代码与门禁;每条新增都用删除别处已有的重复行付账,五个文件的行数上限都没有抬高。回滚即 revert 本 PR。
- **先看:** `references/lanes/spec.md`(规则
2:元数据协议与可搭车改动);`references/lanes/skills.md`(规则
5、6);`references/lanes/devx.md`(规则 1、3、4、7)。
- **两分钟验证:** 运行 `node scripts/pm/check-skill-line-ratchet.mjs`,预期退出
0,SKILL.md 319/319、devx 36/36、server 86/86、spec 43/43、skills 33/33。
- **需要你做的:** 无,席位落地(`.claude/**` 属 Tier S,等合约复核档记录)。
## What changes
Writes the rule set of the two ruling records on #31424 (record
6722023475, rules 1–4; record 6722123324, rules 5–7). Each rule is
stated once, in its owning file; the others point at it.
| Rule | Owning file | Pointers |
|:--|:--|:--|
| 1 · lane by package, never by trigger; devx keeps `apps/docs`, nav
`meta.json`, the references pipeline, sweeps spanning two or more lanes
| `lanes/devx.md` | SKILL.md devx row; `lanes/server.md` L18;
`lanes/spec.md` L11 (references pipeline no longer listed as spec
tooling) |
| 2 · metadata-protocol change = spec child card at first touch, product
card `Blocked-by:` it; definition; the `packages/spec` riders;
`protocol:*` backstop; `Metadata-protocol:` line not decisive alone |
`lanes/spec.md` | SKILL.md:175 (fifth crossing channel);
`lanes/server.md` L6; `lanes/skills.md` (backstop shape) |
| 3 · `.github/workflows/**` is devx by path; a product card needing one
files a devx card that links back | `lanes/devx.md` | SKILL.md devx row
(the wiring/CI-speed qualifier removed) |
| 4 · `examples/**` test infra = `vitest.config.ts`, fixtures, shared
harnesses; a product-behaviour pin rides the subsystem it exercises |
`lanes/devx.md` | SKILL.md devx row and the no-fixed-owner row |
| 5 · published `skills/**` = skills child card at first touch,
`Blocked-by:` the product card; product PRs do not edit `skills/**` and
name the child; a touching hunk moves | `lanes/skills.md` | — |
| 6 · internal rules never ride a product PR; a rule change is a
decision card first; a no-rule fix goes to skills directly; new gates
still default to no | `lanes/skills.md` | — |
| 7 · devx chartered as AI-worker pipeline efficiency, six metrics;
rules and knowledge to skills, tooling and pipeline to devx |
`lanes/devx.md` | — |
`lanes/server.md` L18 also drops the stale line that sent
`content/docs/**` and `packages/lint` to devx; `packages/lint` now
points at the SKILL.md devx row instead of restating it. The triage
dashboard display (rule 7's last bullet) and #31538 are out of scope per
the order.
### Line budget (ruling records 6722023475 and 6722123324, under
6184799323 letter B)
No ceiling moves: every added line is paid by deleting a line restated
elsewhere. `scripts/pm/check-skill-line-ratchet.mjs` is untouched.
| File | Before / ceiling | After / ceiling | Measured delta | Added |
Deleted |
|:--|:--|:--|:--|:--|:--|
| `SKILL.md` | 319/319, widest row 341/341 B | 319/319, widest row
341/341 B (devx row 339→339 B) | 0 | 2 rows + L175 rewritten in place
(L175 117→119 B) | 0 |
| `lanes/devx.md` | 35/36 | 36/36 | +1 | 8 | 7 |
| `lanes/server.md` | 86/86 | 86/86 | 0 | 2 rewritten in place | 0 |
| `lanes/spec.md` | 42/43 | 43/43 | +1 | 6 (+2 rewritten) | 5 |
| `lanes/skills.md` | 32/33 | 33/33 | +1 | 6 | 5 |
The devx row's byte payment was in-row: `governed 面` became `受管面`, the
wording `lanes/skills.md` already uses.
### Deletions and their survivors (file:line at this head)
- devx.md 〈路径分叉〉 pointer line → SKILL.md:181, SKILL.md:186
- devx.md changeset pair (`skip-changeset` / real changeset) →
`.claude/agents/os-dev.md`:297–298; AGENTS.md Post-Task Checklist step 3
- devx.md card-body-is-frozen pair →
`references/execution-duties.md`:11; SKILL.md:236
- devx.md `FETCH_HEAD` is shared → AGENTS.md:353 (`refs/remotes/*` and
`FETCH_HEAD` are the two that bite); devx.md:32
- devx.md enumeration never silently becomes a no-op → devx.md:34
(anti-idle limb); AGENTS.md section "Writing a `--self-test`"
- spec.md metadata format or acceptance goes to spec / `/meta` route →
spec.md:13 (rule 2); server.md:70
- spec.md 〈席内判断〉 candidate comments must be read (with its now-empty
heading) → `references/execution-duties.md`:11; SKILL.md:236
- skills.md PM tooling ownership pointer → skills.md:9; SKILL.md:161
- skills.md QA loop belongs to `qa#1` → `references/lanes/qa.md`:2, :28
- skills.md quota-exhaustion floor →
`references/execution-duties.md`:120
- skills.md first-touch each round / decision box with four facets /
never self-rule → `references/triage-duties.md`:17; SKILL.md:270, :276
- skills.md findings first-touch belongs to triage → SKILL.md:170–171;
skills.md:24
## Tests
Rule text only; no code or test moves. Gates below.
## Acceptance notes
- **Declared deviation:** `lanes/server.md` L6 (the red line "any card
touching `packages/spec` goes to the spec seat") is rewritten to a
pointer at `lanes/spec.md`. The order mapped server.md to L18 only, but
L6 states the opposite of rule 2's riders; the file is inside the
claim's surface and the edit is line-neutral.
- **Fixed in this PR on the seat's rework (claim amendment
6722677217):**
- SKILL.md:175 now names five boundary-crossing channels; the fifth is
rule 2's `packages/spec` riders, pointing at `lanes/spec.md`.
Line-neutral, 119 B: the two existing items were shortened to the names
`dispatch-runbook.md` already uses (无主阻塞项) or dropped their subject
prefix (跟到底的越界面).
- `lanes/spec.md`:11 no longer lists the references pipeline as spec
tooling (rule 1 gives it to devx); the regenerated references output
still rides its source PR, per `lanes/spec.md`:9.
- **Left for the seat's own card, not edited:** SKILL.md:313, the claim
template's `Skills-docs: updated here` arm ("this diff teaches it in
`skills/**`"), conflicts with rule 5 for a product-lane PR. Filed as
#31555.
- **Rule 7's dashboard line, filed:** "triage shows the six metrics in
the daily dashboard's lane section" (record 6722123324) belongs to
triage, not a lane file; it goes to `triage-duties.md` under #31558
(director review 6722830741 item ⑤).
## Verification
Derived gate sweep (`node scripts/pm/dispatch-gates.mjs --commands
--repo objectstack-ai/objectstack`): 21 commands, first run at
`3cfa13e1` after the `@objectstack/formula` + `@objectstack/lint` build
(lock VERDICT command-exit 0), re-run in full at head `1d5f769c` (rework
+ `origin/main` merged): same 21-command list, all exit 0, --ran 21/21,
0 NOT-MEASURED.
<details><summary>21 derived gates, all exit 0; --ran reconciliation
21/21, 0 NOT-MEASURED</summary>
```
node scripts/check-closing-keyword-parity.mjs :: exit 0
node scripts/check-closing-keyword-parity.mjs --self-test :: exit 0
node scripts/check-comment-mask-corpus.mjs :: exit 0
node scripts/pm/check-governed-queue-guard.mjs --self-test :: exit 0
node scripts/pm/check-harness-current.mjs --self-test :: exit 0
pnpm --filter @objectstack/lint run check:doc-formula-expressions :: exit 0
pnpm check:agent-test-spelling :: exit 0
pnpm check:cross-package-test-inputs :: exit 0
pnpm check:doc-authoring :: exit 0
pnpm check:driver-memory-census :: exit 0
pnpm check:gitlink-declared :: exit 0
pnpm check:nul-bytes :: exit 0
pnpm check:pm-expected-skips :: exit 0
pnpm check:pm-governed-merges :: exit 0
pnpm check:pm-governed-prose :: exit 0
pnpm check:pm-label-write :: exit 0
pnpm check:pm-skill-id-lint :: exit 0
pnpm check:pm-skill-ratchet :: exit 0
pnpm check:refd-timer-probe :: exit 0
pnpm check:skill-frame-sync :: exit 0
pnpm check:watch-hint-literal :: exit 0
```
</details>
Merged `origin/main` twice (`f923bc1e`, then `6f9f0086`; neither touches
these five files); at head `1d5f769c`: `node
scripts/pm/check-skill-line-ratchet.mjs` exit 0, its `--self-test` exit
0, `pnpm check:pm-skill-id-lint` exit 0, `pnpm check:pm-skill-ratchet`
exit 0.
---
_Generated by [Claude
Code](https://claude.ai/code/session_01QsR2jTdqyEtLSzFr9HrUCq)_
---------
Co-authored-by: Claude <noreply@anthropic.com>1 parent 8c75f83 commit 099a037
5 files changed
Lines changed: 27 additions & 24 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
157 | 157 | | |
158 | 158 | | |
159 | 159 | | |
160 | | - | |
| 160 | + | |
161 | 161 | | |
162 | 162 | | |
163 | 163 | | |
164 | 164 | | |
165 | 165 | | |
166 | | - | |
| 166 | + | |
167 | 167 | | |
168 | 168 | | |
169 | 169 | | |
| |||
172 | 172 | | |
173 | 173 | | |
174 | 174 | | |
175 | | - | |
| 175 | + | |
176 | 176 | | |
177 | 177 | | |
178 | 178 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
7 | 11 | | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
8 | 16 | | |
9 | 17 | | |
10 | 18 | | |
| |||
15 | 23 | | |
16 | 24 | | |
17 | 25 | | |
18 | | - | |
19 | 26 | | |
20 | | - | |
21 | | - | |
22 | 27 | | |
23 | 28 | | |
24 | 29 | | |
25 | 30 | | |
26 | | - | |
27 | | - | |
28 | 31 | | |
29 | 32 | | |
30 | | - | |
31 | 33 | | |
32 | 34 | | |
33 | | - | |
34 | 35 | | |
35 | 36 | | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
3 | 3 | | |
4 | 4 | | |
5 | 5 | | |
6 | | - | |
| 6 | + | |
7 | 7 | | |
8 | 8 | | |
9 | 9 | | |
| |||
15 | 15 | | |
16 | 16 | | |
17 | 17 | | |
18 | | - | |
| 18 | + | |
19 | 19 | | |
20 | 20 | | |
21 | 21 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
8 | | - | |
9 | 8 | | |
10 | 9 | | |
11 | | - | |
12 | 10 | | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
13 | 17 | | |
14 | 18 | | |
15 | 19 | | |
16 | 20 | | |
17 | 21 | | |
18 | 22 | | |
19 | | - | |
20 | 23 | | |
21 | | - | |
22 | | - | |
23 | 24 | | |
24 | 25 | | |
25 | 26 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
8 | 8 | | |
9 | 9 | | |
10 | 10 | | |
11 | | - | |
12 | | - | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
13 | 19 | | |
14 | 20 | | |
15 | 21 | | |
| |||
21 | 27 | | |
22 | 28 | | |
23 | 29 | | |
24 | | - | |
25 | 30 | | |
26 | 31 | | |
27 | 32 | | |
| |||
36 | 41 | | |
37 | 42 | | |
38 | 43 | | |
39 | | - | |
40 | | - | |
41 | | - | |
42 | | - | |
| |||
0 commit comments