Skip to content

Commit 93cdc43

Browse files
docs(pm-dispatch): new gates default to NO, 「声明即强制」 scoped, rulings complete at ruling time (#19654)
Fixes #19647 Clause-②: no Three governed-text sentences land in the escalation decision frame and in the director charter. Every file in the diff sits at a shrink-only line ceiling, so each added line is paid inside the SAME file: **net +0 lines everywhere**. ## Source — the maintainer's own words, verbatim and untranslated Ruling record: `objectstack-ai/objectui#10094` (the recommendation that prompted the correction) and `objectstack-ai/objectui#10179` (the sub-question left as a separate card). 1. 「我强调了淡化门禁,尤其这个完全没有业务价值,你为什么又要加,你的决裁依据是不是要更新」 — maintainer, 2026-09-22. 2. 「我们系统开发了太多无用的门禁,反而在浪费时间」 — maintainer, 2026-09-21 (standing). 3. 「更新你的技能,既然在决裁了,就一次性决裁清楚,不要等dev再立决裁卡」 — maintainer, 2026-09-22. ## What lands | # | Sentence | Where | |:--|:--|:--| | ① | **新增门禁默认否** — 门禁是只减不增的零件,例外只有维护者点名;荐新增门禁须引其点名原话,否则荐「不加」。 | SKILL.md axis ④ 创业阶段不扩散 · core-rules.md 四轴 line | | ② | 「声明即强制」只及 spec 与元数据契约、运行时能力,⛔ 不及 `AGENTS.md` 这类给 agent 读的约定 —— 那些的读者是 agent,不是门禁。 | SKILL.md 基本裁决原则 · core-rules.md 基本裁决 line | | ③ | 裁决一次裁清:子问题、分叉与执行参数同笔裁定;⛔ 不另立决策卡,仅前提被证伪才回箱。 | SKILL.md 〈升级与决策〉 · director.md 基本原则 | ## Premise correction — `.claude/agents/os-dev.md` is deliberately NOT touched The dispatch named `os-dev.md` as a second synced copy of the four-axis frame. It is not one, and it must not become one: - `os-dev.md` carries no frame; its own line reads 「框架唯一副本在 pm-dispatch SKILL.md 〈升级与决策〉;派发词逐字粘贴,dev ⛔ 不留副本」. The two dev-side copies were deleted by the 2026-09-03 batch-3 ruling (item 4, option B). - `check-skill-frame-sync.mjs` declares exactly ONE copy in `COPIES` (`.claude/skills/pm-dispatch/SKILL.md`), and its anti-dormancy scan refuses an undeclared one. Its self-test pins that refusal at this very path: case `the dev-side copy returns to the now-undeclared agent definition → red (anti-dormancy)`. So writing ① ② into `os-dev.md` would have turned `check:skill-frame-sync` red on purpose. 「every synced copy」 resolves, today, to SKILL.md alone — which is what this PR edits. ## Line budget — paid in the same file, per the card | file | before | after | ceiling | payment | |:--|--:|--:|--:|:--| | `.claude/skills/pm-dispatch/SKILL.md` | 819 | 819 | 819 | the two frame paragraphs drop their provenance parentheticals (dates + ruling quotations) and compress prose; axis ④ 6 → 5 lines funds ③'s new line | | `.claude/skills/pm-dispatch/references/core-rules.md` | 151 | 151 | 151 | `落卡与呈报带 Governing text:` moves onto the adjacent 落卡 line, freeing its line for the 基本裁决 clause; the 四轴 line absorbs ① by dropping a redundant pointer | | `.claude/skills/pm-dispatch/references/lanes/director.md` | 63 | 63 | 72 | the two coupled `pm:awaiting-maintainer` rules merge onto one line | | `.claude/agents/os-dev.md` | 403 | 403 | 403 | untouched (see above) | ⛔ No ceiling is raised. ⛔ No re-wrap is used as 筹行 — every line is paid by deleted or merged CONTENT. Every rule is kept. **The one judgement call for the maintainer.** The payment is the residual provenance in the two frame paragraphs: the 2026-08-04, 2026-08-27 and 2026-09-10 ruling dates and quotations. They are the last provenance left in this file, and dropping them is what the standing 2026-09-04 direction 「各条规则的出处叙事、事故复盘 根本不重要啊,不需要写入skills啊」 already did to the rest of the corpus — `director.md` carries 创业阶段不渐进 as a bare rule line today for exactly that reason, and `AGENTS.md` states it as a rule of its own (「a rule ... carries no incident narrative, no ruling date or quotation」). The rulings stay recorded — in `packages/spec/src/migrations/registry.ts`, in the ratchet script's own ceiling comments, in git history, and in this PR body. The 2026-08-04 principle is not lost: it lands as the rule sentence 「创业项目先专注核心能力」. ## Verification Derived with `node scripts/pm/dispatch-gates.mjs --commands --repo objectstack-ai/objectstack` (no paths — the tool takes its own change set from the merge base), at `442b960`. - **21 derived gate families, 21 run, 0 NOT-MEASURED, 0 UNRUN** — reconciled with the --ran flag pointed at a record file, where every line carries a double-colon `exit` marker plus the code, captured before any pipe. Verdict line: `✓ dispatch-gates --ran: 21 derived famil(ies) accounted for — 21 run, 0 NOT-MEASURED (a DERIVED zero — all 21 recorded an exit code and none of them is 3)`. - The card's four named gates, all exit 0: `check:pm-skill-ratchet` (SKILL.md 819/819, core-rules.md 151/151, director.md 63/72, os-dev.md 403/403), `check:skill-frame-sync` (`4 axes: business-need → long-term-soundness → ai-authoring-safety → startup-scope-discipline`, binding sentence present, 1 count mention agrees, 77 markdown files scanned), `check:skill-frame-freshness`, `check:pm-skill-id-lint`. - Run beyond the derivation, all exit 0: `check:skill-frame-freshness`, `check:pm-settings-deny-roster` (its roster lives under `.claude/`, so its silence is not evidence either way), `node scripts/check-skills-token-ratchet.mjs`. - `pnpm --filter @objectstack/lint run check:doc-formula-expressions` first exited **3** — PREREQUISITE NOT MET, nothing measured. Re-run after `pnpm exec turbo run build --filter=@objectstack/formula --filter=@objectstack/lint`: exit 0. - **Repo-wide `pnpm lint` is narrowed, and the narrowing is measured** (at `442b960`): ① population read from `eslint.config.mjs` itself — every `files:` selector is a `{ts,tsx,mts,cts,js,jsx,mjs,cjs}` glob and no block selects `.md`; ② count read from `eslint --format json` over the three changed files: 3 entries, 0 messages, exit 0; ③ invariance — no rule block matches a markdown path, so this diff cannot move the verdict of any file it does not touch. No package is touched, so there is no `①` dependency-closure build and no package `test`/`typecheck` owed; CI's type-check lanes are declared CI-only by the derivation. - No changeset: `.claude/**` publishes nothing from any released package — hence `skip-changeset`. ## Acceptance notes Noted, not filed, not fixed here — the card fences the diff with 「⛔ No other framework text changes ride on this card」. 1. **`SKILL.md` 机械守卫索引 row is stale and actively misleading** (class a, reproducible today): the row reads `check:skill-frame-sync / -freshness | 四维决策框架两份拷贝的同构与 新鲜度` — 「两份拷贝」, two copies. `COPIES` in `scripts/check-skill-frame-sync.mjs` has held exactly one entry since the 2026-09-10 deletion. Reading the row as written is what produced this card's own false premise (「both synced copies ... and os-dev.md」), and acting on it turns `check:skill-frame-sync` red — the gate's self-test pins that outcome. One-line fix: `两份拷贝` → `唯一一份拷贝`. Dedupe words: `两份拷贝` · `skill-frame-sync COPIES one copy` · `机械守卫索引 stale row`. 2. **`check-skill-frame-sync.mjs`'s `wording-only divergence` self-test case anchors on hand-copied prose** (class a, hit in this run): it locates its mutation target in the real `SKILL.md` by the literals `长期代价` / `创业项目` / `不作数`. Rewording any of them throws `self-test fixture drifted` before the gate scans anything — a dead gate whose presence in the gate list still reads as coverage. That is precisely the defect the same file's own `axisEntryStarts` docblock records and repairs for a sibling fixture ("locating the entry through THIS parser instead means the fixture depends on the frame's structure"). This PR worked around it by keeping 创业项目 in the text. Out of scope here: the fix is in a gate script, which would owe that script's own test suite — a new verification surface. Dedupe words: `frame-sync self-test fixture drifted` · `mutation target hand-copied literal` · `wording-only divergence anchor`. ## 维护者速读(草稿) **改了什么** —— 往决策框架里加三句话:① 新增门禁默认否(门禁是只减不增的零件,想加必须引您 点名的原话,否则一律荐「不加」);②「声明即强制」只管 spec、元数据契约和运行时能力,不管 `AGENTS.md` 这种写给 agent 看的约定;③ 裁决一次裁清,子问题、分叉和执行参数同一笔定完,不 再把半个问题丢给 dev 去「另立决策卡」。三个文件都在只降不升的行数天花板上,加的每一行都在同 一个文件里用删减付账,四个文件净增都是 0。 **为什么改** —— 总监席在 objectui 那张卡上,用「这个缺陷已经修过一次」推荐了一条新的必需门 禁,而您的长期方向是删门禁。框架里没有一句话说「新增门禁默认否」,而「声明即强制」写得太宽, 宽到有人把一条没有机器读者的 `AGENTS.md` 约定读成「声明了却没强制 ⇒ 该加门禁」。第三句是另 一件事:您指出既然在决裁,就该一次决裁干净,不要留个尾巴等 dev 再立一张决策卡。 **风险与代价(含回滚)** —— 只改文字,不改任何代码或运行时行为,回滚就是 revert 这个 PR。 真正要您拍板的只有一处:天花板逼我用「删」来付账,我删的是这两段里残留的出处(2026-08-04、 2026-08-27、2026-09-10 三处日期加引文)。依据是您 2026-09-04 的那句「各条规则的出处叙事、 事故复盘 根本不重要啊,不需要写入skills啊」,以及 `AGENTS.md` 自己那条「规则不带裁决日期与 引文」;`director.md` 里同一条「创业阶段不渐进」早就是不带引文的裸规则了。裁决本身没丢: spec 的迁移登记表、棘轮脚本的天花板注释、git 历史和这份 PR 正文都留着原话,2026-08-04 那条 原则则直接落成规则句「创业项目先专注核心能力」。您要是希望引文留在 skills 里,请回一句,我 改成抬天花板的方案重报(那需要您给一个新的上限数)。另外派发把 `.claude/agents/os-dev.md` 当成框架的第二份拷贝,它不是——那边的拷贝是 2026-09-03 裁掉的,门禁的自测专门钉着「拷贝回 到 os-dev.md 就红」,所以这个文件一个字没动。 **席位意见** —— **你要做的** —— 读一遍上面三句话是不是您的意思,尤其是第二句的边界(「只及 spec 与元数据契 约、运行时能力」),然后一次亲合。⛔ 我不合并、不请审、不翻 ready。 --- _Generated by [Claude Code](https://claude.ai/code/session_01SPwf6Kmqo1gqzCSWSuMtQM)_ --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent e9861d2 commit 93cdc43

3 files changed

Lines changed: 16 additions & 16 deletions

File tree

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

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -737,6 +737,7 @@ PM 的工作是循环:选卡 → 认领 → 派发 → 收集 → 复核 → 报
737737
- 卡上裁决评论是详注,仍是执行与复核的第一落点。
738738
- 裁决点名文件/符号/行/调用形状的条款,逐条带读数或注「未验证」;只引规则的条款免。
739739
- 出决策箱须引同趟取回过的裁决 id 与 `Governing text:` 项,⛔ 时间戳加回忆不算引用。
740+
- 裁决一次裁清:子问题、分叉与执行参数同笔裁定;⛔ 不另立决策卡,仅前提被证伪才回箱。
740741
**每个方案必须沿四条固定评估轴分析,这是决策分析的核心原则,不是可选项:**
741742

742743
- **实际业务需求** — 它服务的是**真实存在的业务场景**,
@@ -747,16 +748,15 @@ PM 的工作是循环:选卡 → 认领 → 派发 → 收集 → 复核 → 报
747748
- **防 AI 写代码犯错,尤其是防 AI 写元数据 app 犯错** — 哪个方案让 AI 在结构上*更难写错*:
748749
契约收紧(严格 schema、publish 时响亮拒绝)优于消费端宽容(`??` 回退、静默容错)——
749750
宽容恰是 AI 批量犯错被掩盖的温床;声明即强制,绝不让 AI 声明一个运行时不兑现的能力。
750-
- **创业阶段不扩散需求** — **创业阶段聚焦原则**(维护者 2026-08-04 指示:
751-
「我们是一个创业项目,应该先专注于核心能力」):能力扩张默认从紧,
752-
无拉动的声明面按 implementation-first 处置,已发布零消费的能力不因沉没成本获得豁免。
753-
**过渡也从紧 —— 创业阶段不渐进**(维护者 2026-08-27 裁,逐字:「项目在创业阶段,
754-
用户也很少,短期不考虑渐进。」):废弃别名/拼写与能力退役默认**立即退休**,
755-
不设分阶段窗口、不留双拼写宽限;staged 选项仅凭具名外部用户证据才可呈报为推荐。
756-
757-
**基本裁决原则**(维护者 2026-09-10 指示,逐字:「我们的项目以objectstack 协议为准,
758-
文档应该以实际实现为准。协议不正确的应该先修改协议。」):spec 声明 > 实现 > 文档面;
759-
声明而未兑现是实现缺口,补实现或退役,⛔ 不在消费端收窄;未声明键随实现,文档随之。
751+
- **创业阶段不扩散需求** — **创业阶段聚焦原则**:创业项目先专注核心能力,能力扩张默认
752+
从紧,无拉动的声明面按 implementation-first 处置,已发布零消费能力不因沉没成本豁免。
753+
**过渡也从紧 —— 创业阶段不渐进**:废弃别名/拼写与能力退役默认**立即退休**,无分阶段
754+
窗口、无双拼写宽限;staged 仅凭具名外部用户证据方可荐。**新增门禁默认否**:门禁是只减
755+
不增的零件,例外只有维护者点名;荐新增门禁须引其点名原话,否则荐「不加」。
756+
757+
**基本裁决原则**:spec 声明 > 实现 > 文档面;声明而未兑现是实现缺口,补实现或退役,
758+
⛔ 不在消费端收窄;未声明键随实现,文档随之。「声明即强制」只及 spec 与元数据契约、
759+
运行时能力,⛔ 不及 AGENTS.md 这类给 agent 读的约定 —— 那些的读者是 agent,不是门禁。
760760
推荐意见必须基于这四条轴给出理由;四轴冲突时如实呈现权衡,
761761
交维护者拍板。
762762
- 分歧推荐序按拉动定向:有实测拉动 ⇒ 荐长远形态一次付清;零拉动 ⇒ 荐不扩散。
@@ -797,7 +797,7 @@ PM 的工作是循环:选卡 → 认领 → 派发 → 收集 → 复核 → 报
797797
| `scripts/pm/git-history.mjs` | 窗口化 commit 计数:回答或 REFUSE(浅 clone 对窗口化 `git log`/`rev-list` 以 exit 0 无警告答错);`historyHorizon()` 是只读谓词 |
798798
| `scripts/pm/os-regen-merge.sh` | 碰生成物 PR 的 merge 四步序(防静默吞并与锚点倒退) |
799799
| `scripts/pm/ensure-pm-labels.sh` | pm 标签词表的幂等一次性创建;退役车道刻意不在 ⛔ 不加回,对象清理以脚本头为权威 |
800-
| `check:skill-frame-sync` / `-freshness` | 四维决策框架两份拷贝的同构与新鲜度 |
800+
| `check:skill-frame-sync` / `-freshness` | 四维决策框架唯一一份拷贝的同构与新鲜度 |
801801
| `guard-main-checkout` / `guard-shared-stash` hooks | worktree-first 与 stash 禁令的机械面 |
802802

803803
## 模板与表

‎.claude/skills/pm-dispatch/references/core-rules.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -137,11 +137,11 @@
137137
- 记账不升级(无产品可见行为变化):去重并卡、理台账、纯文档措辞、既有门禁盲区加强。
138138
- 带前提的裁决三件缺一不可:选路线、挂具名可证伪前提、前提不成立必须报分叉。
139139
- 同族近似单默认并入既有拒收集;两个实现不一致时带治理的一侧胜出并删另一侧。
140-
- 落卡先刷新前提,每条前提行自带一条 re-check 命令;决策默认锚在所属 issue。
140+
- 落卡先刷新前提,前提行自带 re-check 命令;决策默认锚在所属 issue,呈报带 `Governing text:`。
141141
- 裁决记录四件同笔:鲜度门、状态转换、依赖行活性现验、条件已知即就地判掉。
142142
- 出决策箱须引一个同趟取回过的裁决 id,⛔ 时间戳加回忆不算引用。
143-
- 落卡与呈报带 `Governing text:`;基本裁决原则:协议为准,文档以实现为准,协议错另立卡先改。
144-
- 方案逐轴过升级与决策段的四轴:业务需求、长远合理性、防 AI 写错、创业阶段聚焦。
143+
- 基本裁决:协议为准,文档随实现,协议错先改;声明即强制限 spec/元数据契约与运行时能力。
144+
- 方案逐轴过四轴:业务需求、长远合理性、防 AI 写错、创业阶段聚焦(新增门禁默认否)。
145145
- 推荐须逐轴给理由、长远权重不低于一半;有拉动荐长远终态一次付清,零拉动荐不扩散。
146146
- 每张决策卡落卡即带标准四棱块;卡先于弹窗,被阻塞的执行卡同笔转 `pm:blocked`。
147147
- 项目总监席由人工召唤,未回字 = 不在 = 停;三职:复核审计、决裁、动作台账。

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@
2222

2323
- 三要素:每批 5 张;每卡从业务角度讲清问题、选项与代价;每卡带四维分析加一个推荐。
2424
- 创业阶段不渐进:废弃别名与能力退役默认立即退休,无窗口、无双拼写宽限。
25+
- 一次裁清:子问题、分叉与执行参数(字母、车道、级别)同笔裁定,⛔ 不留 dev 另立决策卡。
2526

2627
## 职责一:`needs:contract-review` 事后审计与抽查(可选)
2728

@@ -53,8 +54,7 @@
5354
## 职责三:维护者动作台账
5455

5556
- `pm:awaiting-maintainer` 跨仓标签是待人工动作的唯一机器载体。
56-
- 该态 = 决定已做、只剩一次 GitHub 之外的人工动作。
57-
- 车道席照旧只负责入态,台账与出口归本席。
57+
- 该态 = 决定已做、只剩一次 GitHub 之外的人工动作;车道席只负责入态,台账与出口归本席。
5858
- 待您清单与待字索引随所属批只呈一次,⛔ 不逐轮重印;座位贴散文降为指针,标签即状态。
5959
- 出口执行:核验动作确已发生,再摘标加证据评论同笔;出口条款见 `../state-machine.md`。
6060

0 commit comments

Comments
 (0)