Skip to content

Commit abe980c

Browse files
claude[bot]claude
andauthored
docs(pm-skill): rules-only rewrite of the readings ledger, the REST table and the eight lane job descriptions (#15641)
* docs(pm-skill): rewrite the readings ledger as rules only One fact per line: the platform behaviour plus what a seat does because of it. Numbers a seat acts on stay; how they were measured does not. Four folded readings land here: the MCP list_issues labels array is a union and its totalCount is the disjunction; the container GitHub egress is proxy-credentialed; the job-log endpoint is refused by that proxy while the check-run annotations endpoint carries the exit code; enable_pr_auto_merge stores merge whatever was requested and the branch rule governs the landing method. The clause-2 checker reading that no longer reproduces is restated as its current reading rather than kept with a since-then tail. 397 -> 359 lines; 0 dates, 0 corner quotes, 0 non-table lines over 120 bytes. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox * docs(pm-skill): rewrite the REST channel table as rules only Per-operation channel ownership stays; the per-row provenance dates and the measurement narrative go. The check mark keeps its operative meaning — this shape was actually executed from a gate-open seat — because two rows are documented-but-never-called and a reader has to be able to tell them apart. Adds the update-branch route folded in from its own card: PUT on pulls/{n}/update-branch is the zero-file-write way to merge origin/main into a PR head, expected_head_sha must be the full 40-character SHA, and a base that has not moved answers 422 with nothing to do rather than a failure. 88 -> 82 lines; 0 dates, 0 corner quotes, 0 lines over 120 bytes. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox * docs(pm-skill): rewrite the eight lane job descriptions as rules only Each lane keeps scope, duties per round, hand-offs and its never-list, in plain lines a reviewer can read. What goes: the ruling citations and their dates, the supersession ledgers recording which ruling moved a duty when, the charter quotations, and the incident stories behind a rule. Where a story IS a rule's condition it survives as one clause. No scope moves in either direction; no current-state values (the cli lane's dispatch-to-draft-PR baseline number goes, since the main file already says the baseline is read from the lane's own record and is never a constant). The skills lane's tier line now names tiers instead of model identifiers. cli 31->29, devx 39->38, director 72->72, engine 36->32, hotcrm 57->53, services 28->27, skills 35->33, spec 46->43; every file 0 dates, 0 corner quotes, 0 lines over 120 bytes, no decision-frame fingerprint. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox * docs(pm-skill): rewrite the three small references as rules only release-aftercare keeps every duty and every number a seat acts on — the latency-to-server-time shape, the 200ms gate boundary, the waker-follows physics and the fixed protocol order — and drops the two-day operations log that produced them. Where a failure mode IS the rule's condition it survives as one clause with no date. true-green keeps the per-repo invocation, the gates a CI-log grep cannot see and the local preflight, one fact per line. compile-surfaces keeps its lookup table. The surface rows are unchanged byte for byte, so the widest-table-row pin stays where it is; only the thawed row loses its two dates and the retired in-scope wording, and the prose around the table loses its measurement provenance. release-aftercare 58->50, true-green 33->32, compile-surfaces 26->24. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox * chore(pm): re-pin the thirteen rewritten ceilings at their landed counts All thirteen fall, none rises: platform-readings 397->359, rest-channel 88->82, release-aftercare 58->50, true-green 34->32, compile-surfaces 26->24, lanes engine 40->32, services 28->27, cli 31->29, devx 39->38, skills 35->33, spec 46->43, hotcrm 57->53, director 77->72. Every widest table-row pin is untouched, compile-surfaces included, because its widest row is unchanged byte for byte. The cross-file move declared on platform-readings needed one maintenance edit the header itself prescribes. Its destination no longer stands 73 lines above the 314 it moved from — the rewrite handed 38 of those ruled lines back — so the two ruledRaises records together read as an over-claim and the gate refused them. The third-increment record is retired, which is the header's own remedy for a ruled raise since given back; the intake record stays, so the declaration reads +11 against a net source decrease of 20 for a move that took +10. Under-pricing the move is the failure the header warns about, and this errs the other way. The move's `was`, its sources and their pre-move ceilings are untouched. Ratchet green including its 155-case self-test; check-published-list-mirrors, check-ratchet-remedy-authority, check-skills-token-ratchet and dispatch-gates (1445 cases) all green on the edited script. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox * docs(pm-skill): restore six literal spellings the identifier sweep found missing Every backticked token in the thirteen old files was checked against the thirteen new ones, the rewritten SKILL.md and the rewritten seven references. Six of the misses were load-bearing spellings rather than narrative, and each is restored inside an existing line so no ceiling moves: the unexpanded matrix placeholder, the dev scratch directory name, the full large-datasets pagination message, the merge-main command that is the only fix for a stale rerun, the repository setting behind the auto-merge method read-back, and the fully qualified spec zod path. Eighteen misses stand and are listed in the PR body by reason: deliberate tombstones, provenance the rules-only rewrite removes, spellings the rewritten sibling files already carry, and equivalent short forms. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent 0467941 commit abe980c

14 files changed

Lines changed: 780 additions & 800 deletions

File tree

Lines changed: 12 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,9 @@
1-
# 过滤 / 谓词语义的编译面清单(references —— 按需加载)
1+
# 过滤与谓词语义的编译面清单
22

3-
出处:主文件「派发」
4-
的过滤/谓词语义标准条款 —— 命中该条款的派发令把本清单**逐面抄进去**,PR 逐面申报。
5-
维护纪律与派发前复核串在正文内,
6-
一并适用:**这张表由 PR 维护、派发前先跑复核串重验,⛔ 不凭记忆抄**。
3+
见 SKILL.md 〈派发〉的过滤与谓词语义条款;命中它的派发令逐面抄进本清单,PR 逐面申报。
4+
维护纪律与复核串一并适用:这张表由 PR 维护、派发前先跑复核串重验,⛔ 不凭记忆抄。
75

8-
编译面清单(逐面实测 @ `main` `48f98b0`,2026-08-07):
6+
编译面清单(行号每天在动,派发前按下方复核串重验):
97

108
| # | 面 | 落点(file:line) | 备注 |
119
| --- | --- | --- | --- |
@@ -15,12 +13,12 @@
1513
| 4 | service-analytics filter-normalizer | `packages/services/service-analytics/src/strategies/filter-normalizer.ts:1235`(`lowerAnalyticsWhere`) | analytics / cube 侧 |
1614
| 5 | `formula` | `packages/formula/src/matches-filter.ts:73`(`matchesFilterCondition`) | RLS 写侧 `check` 与公式求值;JS 两值语义的基准面 |
1715
| 半面 | objectql `having-filter` | `packages/objectql/src/having-filter.ts:92` / `:98`(`applyHaving` / `matchesHaving`) | 聚合**后**过滤。算半面是因为词表是子集,**但申报义务不打折** —— 它是**唯一没有 conformance 表覆盖的面**(`FILTER_LOGIC_CASES` 不驱动 HAVING 路径),所以漏了它连门禁都不会红 |
18-
| 已解冻 | `driver-memory` / `driver-mongodb` | `packages/drivers/driver-memory/src/memory-matcher.ts:134`(`checkCondition`)、`packages/drivers/driver-mongodb/src/mongodb-filter.ts:700`(`translateFieldOperators`) | 2026-08-05 投入冻结,**2026-08-11 两条裁决解除** ⇒ 「不在范围 + 冻结指令」作废,按普通面申报 |
16+
| 已解冻 | `driver-memory` / `driver-mongodb` | `packages/drivers/driver-memory/src/memory-matcher.ts:134`(`checkCondition`)、`packages/drivers/driver-mongodb/src/mongodb-filter.ts:700`(`translateFieldOperators`) | 冻结指令与不在范围的旧判定均已作废,按普通面申报 |
1917

20-
**这张表本身由 PR 维护 —— 与域表同一纪律。
21-
** 增删一面(新驱动、新求值器、某面被合并或退役、冻结状态变化)的那个 PR 顺手改这里,
22-
不留给下一次裁决重新数。清单**会**过期是必然的,清单**没有维护者**才是缺陷。
23-
24-
⚠️ 派发前复核一遍再抄,⛔ 不要凭这张表的记忆填派发令:本仓的包路径搬过家(驱动进
25-
`packages/drivers/`、服务进 `packages/services/`),行号更是每天在动。一条够用的复核串:`grep
26-
-rn 'matchesFilterCondition\|buildWhereSQL\|compileScopedFilterToSql' packages --include=*.ts | grep -v node_modules`。
18+
增删一面的那个 PR 顺手改这里,不留给下一次裁决重新数。
19+
触发增删的四种事件:新驱动、新求值器、某面被合并或退役、冻结状态变化。
20+
清单会过期是必然的,清单没有维护者才是缺陷。
21+
派发前复核一遍再抄,⛔ 不凭本表的记忆填派发令:包路径搬过家,行号更是每天在动。
22+
一条够用的复核串:
23+
`grep -rn 'matchesFilterCondition\|buildWhereSQL\|compileScopedFilterToSql'
24+
packages --include=*.ts | grep -v node_modules`。
Lines changed: 15 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,29 @@
1-
# 车道岗位说明:domain:cli(references/lanes —— 座位贴指针指向本文件)
1+
# 车道岗位说明:domain:cli
22

3-
岗位说明版本化于此,升级走技能 PR;现值状态恒在座位贴,⛔ 不迁入本文件。
3+
见 SKILL.md 〈座位贴协议〉;本文是本车道岗位说明,现值状态恒在座位贴,⛔ 不迁入本文。
44

55
## 范围
66

77
- `packages/cli`、`runtime`、`verify`、`qa`、`types`、`packages/rest`、
88
`packages/mcp`、`packages/observability`、`packages/client*`、
99
`cloud-connection`、`create-objectstack`、`packages/adapters/*`、
1010
`plugin-hono-server`、`plugin-dev`。
11-
- 红线:按落点判归属 —— 标题挂 cli 而落点在别包的卡只上报误标不改签;
12-
`packages/spec` 恒归 spec 座位;`/meta` 路由**本体**归本席,元数据格式/接受面归
13-
`domain:spec`。
11+
- 红线:按落点判归属 —— 标题挂 cli 而落点在别包的卡只上报误标,⛔ 不改签。
12+
- `packages/spec` 恒归 spec 座位。
13+
- `/meta` 路由本体归本席,元数据格式与接受面归 `domain:spec`。
1414

1515
## 常设承诺
1616

17-
- **PR 侧绿 ≠ 队列侧绿**;队列分支读法与边界在 platform-readings(条目名
18-
`main/pr-{number}-{parent sha}`,parent sha 可重建队序;⚠️ ref 在出队后滞留)。
19-
- `dispatch-gates.mjs` 只报**路径推导**的地板 —— 条款②从卡**内容**判且优先于它;已知盲
20-
区:它不点名 `pnpm lint` 族 ⇒ 本车道派发令恒补一句「跑 `pnpm lint`」。
21-
- ⛔ 永不削弱门禁 —— 棘轮上跳是门禁在报你的改动有缺陷;规则文案里自带的逃生舱只用
22-
于它描述的那种情形。
17+
- PR 侧绿不等于队列侧绿;队列分支条目名、队序重建与出队滞留住 `../platform-readings.md`。
18+
- `dispatch-gates.mjs` 只报路径推导的地板,条款②从卡内容判且优先于它。
19+
- 已知盲区:它不点名 `pnpm lint` 族 ⇒ 本车道派发令恒补一句跑 `pnpm lint`。
20+
- ⛔ 永不削弱门禁:棘轮上跳是门禁在报你的改动有缺陷。
21+
- 规则文案里自带的逃生舱只用于它描述的那种情形。
2322

2423
## 席内判断
2524

26-
- **探针的 baseline 也是测量**,而且是没人复查的那个 —— 判据恒读命中行本身,⛔ 不
27-
读命中数;断言「文本被删」的探针要锚在消失的那段上(被删串的前缀在删除后仍然幸
28-
存是构造使然)。
29-
- 静默时长是**发探针**的门槛,永不是判死的(本车道实测基线:派发 → draft PR ≈
30-
35–50 分钟);分支无提交 + SendMessage 探针便宜,且实测能复活假死的 dev —— ⛔ 永
31-
不往可能活着的 worktree 派第二个 agent。
25+
- 探针的 baseline 也是测量,而且是没人复查的那个 ⇒ 判据恒读命中行本身,⛔ 不读命中数。
26+
- 断言文本被删的探针要锚在消失的那段上:被删串的前缀在删除后仍幸存是构造使然。
27+
- 静默时长是发探针的门槛,永不是判死的门槛;基线自本车道实录,⛔ 不写成常数。
28+
- 分支无提交加 SendMessage 探针便宜,且能复活假死的 dev。
29+
- ⛔ 永不往可能活着的 worktree 派第二个 agent。
Lines changed: 25 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,38 @@
1-
# 车道岗位说明:domain:devx(references/lanes —— 座位贴指针指向本文件)
1+
# 车道岗位说明:domain:devx
22

3-
岗位说明版本化于此,升级走技能 PR;现值状态恒在座位贴,⛔ 不迁入本文件。
3+
见 SKILL.md 〈座位贴协议〉;本文是本车道岗位说明,现值状态恒在座位贴,⛔ 不迁入本文。
44

55
## 范围
66

77
- `packages/lint`、`packages/sdui-parser`、`content/docs/**`、`apps/docs`、
88
`scripts/`(门禁类)、`.github/workflows/`(门禁接线)、`.githooks/`、
99
`examples/**` 测试基建面、`docker/README.md`。
10-
- objectui 的本域面同辖:`.github/`、`scripts/`、构建/发布管线与门禁工具(objectui 卡三流分流,判
11-
据见 SKILL.md 多仓协调)。
12-
- 边界:守护 skills 的门禁脚本在 `scripts/` 下时归本席 —— 判据是**被改文件的路
13-
径**,SUBJECT 例外与 spec 三面切分在 SKILL.md 域车道表;`.claude/workflows/`
14-
≠ `.claude/skills/`;**范围内的文件 ≠ 范围内的卡**,归属按卡的 `domain:*` 判,反向亦然(本席卡
15-
的落点溢进他席文件面时,由此产生的人工合并等后果照单接受)。
10+
- objectui 的本域面同辖:`.github/`、`scripts/`、构建与发布管线、门禁工具。
11+
- 边界:守护 skills 的门禁脚本在 `scripts/` 下时归本席,判据是被改文件的路径。
12+
- SUBJECT 例外与 spec 三面切分在 SKILL.md 域车道表;`.claude/workflows/` 不是 `.claude/skills/`。
13+
- 范围内的文件不等于范围内的卡:归属按卡的 `domain:*` 判,反向亦然。
14+
- 本席卡的落点溢进他席文件面时,由此产生的人工合并等后果照单接受。
1615

1716
## 常设承诺
1817

19-
- `content/docs/releases/**` 是 release-owned,恰两条通道:完整性缺口逐卡批准
20-
(⛔ 不构成先例);事实错误走专用 docs-only PR。发布页作用域只管 v16 及以后。
21-
- ⛔ 不做任何发布动作,含改根 `version` 脚本链;**能点绿的门禁不等于该点绿**。
22-
- governed 面 PR 照 SKILL.md「ACCEPT 之后的路径分叉」执行(⛔ 此处不另抄);设计如此的红门禁必
23-
须在 PR 上说明红因并声明不修。
24-
- changeset 按 publish 面判:根 `scripts/` / docs / test-only ⇒ `skip-changeset`;
25-
落进已发布包的源 ⇒ 真 changeset;**收窄接受集**须 lint+spec 双侧语义登记,尤须
26-
慎重。
18+
- `content/docs/releases/**` 是 release-owned,恰两条通道;发布页作用域只管 v16 及以后。
19+
- 通道一:完整性缺口逐卡批准,⛔ 不构成先例。通道二:事实错误走专用 docs-only PR。
20+
- ⛔ 不做任何发布动作,含改根 `version` 脚本链;能点绿的门禁不等于该点绿。
21+
- 受管面 PR 照 SKILL.md 〈复核〉的路径分叉执行,⛔ 此处不另抄。
22+
- 设计如此的红门禁必须在 PR 上说明红因并声明不修。
23+
- changeset 按 publish 面判:根 `scripts/`、docs、test-only ⇒ `skip-changeset`。
24+
- 落进已发布包的源 ⇒ 真 changeset。
25+
- 收窄接受集须 lint 与 spec 双侧语义登记,尤须慎重。
2726

2827
## 席内判断
2928

30-
- **卡片正文冻结在立卡那一刻**,而本仓刻意把裁定/更正/`Blocked-by:` 放在评论里 ——
31-
超过一天的卡,正文是页面上最不当前的东西;先读晚于正文的评论再判可派性。
32-
- **量具在共享 checkout 上会静默说谎**:读内容用 `git show origin/main:` 带路径,跑脚本必须在自
33-
己的 worktree,复核 diff 用具名 ref,⛔ 不用 `FETCH_HEAD`(它是共
34-
享的,会被别的 agent 的 fetch 在两条命令之间冲掉)。
35-
- **门禁的自述必须为真** —— 理由为假的门禁比没有门禁更坏(下一个读者会相信某风险
36-
已被覆盖);新门禁靠**故意复现伤害**自证,语料已被修干净时加反空转肢(某个面读
37-
不出具名 pin 即判失败),⛔ 让枚举静默退化成 no-op。
38-
- 派发词给出的实测值必须同时给「自己重测」的指令(PM 清单会错,dev 重推导是兜
39-
底);先例给的是「怎么想」,不是「怎么改」。
29+
- 卡片正文冻结在立卡那一刻,而本仓刻意把裁定、更正与 `Blocked-by:` 放在评论里。
30+
- ⇒ 超过一天的卡,正文是页面上最不当前的东西;先读晚于正文的评论再判可派性。
31+
- 量具在共享 checkout 上会静默说谎:读内容用 `git show origin/main:` 带路径。
32+
- 跑脚本必须在自己的 worktree;复核 diff 用具名 ref,⛔ 不用 `FETCH_HEAD`。
33+
- `FETCH_HEAD` 是共享的,会被别的 agent 的 fetch 在两条命令之间冲掉。
34+
- 门禁的自述必须为真:理由为假的门禁比没有门禁更坏,读者会相信某风险已被覆盖。
35+
- 新门禁靠故意复现伤害自证;语料已被修干净时加反空转肢,某面读不出具名 pin 即判失败。
36+
- ⛔ 不让枚举静默退化成 no-op。
37+
- 派发词给出的实测值必须同时给自己重测的指令:PM 清单会错,dev 重推导是兜底。
38+
- 先例给的是怎么想,不是怎么改。

0 commit comments

Comments
 (0)