Skip to content

Commit 5a2bdf9

Browse files
docs(skills): record-page rule names drawer and full page as the reader's Open records choices (#29259)
<!-- claude-projects-attribution: {"github_login":"zhuangjianguo"} --> _Requested by **Steedos** · [project thread](https://claude.ai/code/project/chan_018ETKaNwMZCNRYD7D8Q9Ubb?thread=cmsg_018ETKaNwMZCNRYD7D8Q9UbbCFvAws9PJHw556qFuw9stX)_ Fixes #29110 Clause-②: no Metadata-protocol: none ## 维护者速读 - **改了什么**:`objectstack-ui` 技能的记录页规则第 6 条与评测第 2 题,把读者的「打开记录」选项改为抽屉(默认)或整页两种,并写明列表旁的分栏已退役。 - **为什么改**:控制台已退役列表旁分栏、默认改为抽屉打开;技能仍教「分栏为默认」,会让 AI 向作者描述一个已不存在的选项。 - **风险与回滚**:只改发布技能的两段文字与一份 patch changeset,无代码与契约改动;回滚即还原本 PR。 - **先看**:`skills/objectstack-ui/rules/record-page.md` 第 6 条(47–53 行);`skills/objectstack-ui/evals/record-page.json` 第 2 题 `expected_output`。 - **两分钟验证**:`node scripts/check-skills-token-ratchet.mjs`,预期 record-page.md 为 996 tokens(上限 996)且退出码 0。 - **需要你做的**:审阅后批准(本 PR 改动 `skills/**`,需授权审批人批准方可落地)。 ## What changes The console retired the split pane beside the list (#28915, landed as ea150b7): a list record opens in the drawer (the default) or as the full page, and the Display menu's Open records offers Drawer and Full page only. The shipped `objectstack-ui` skill still taught the old model. - `skills/objectstack-ui/rules/record-page.md` rule 6: Open records now reads "drawer — the default — or full page, for a drawer-mode object; the split beside the list is retired". The rest of rule 6 is checked against main's console code and kept: the right-column switch (`RECORD_RELATED_COLUMN_PREFERENCE`), the related panels' order and hidden set (`RECORD_RELATED_ARRANGEMENT_PREFERENCE`), and the drag-resize width and maximize button, which live on the record drawer (`navigation-overlay.tsx` `useDrawerResize`, `maximizable`). One more word changed with it: "the pane's dragged width and ⤢" now says "the drawer's", since the drawer is the only pane left. - `skills/objectstack-ui/evals/record-page.json` eval 2: the prompt is unchanged (reps still ask for records beside the list). The expected answer now says a pane beside the list is no longer offered, that Open records is drawer (the default) or full page, kept in the browser, and that nothing is authored for it; `navigation: { mode: 'page' }` stays the one declaration. The assertions stay as they are and still hold: `must_contain` (`navigation: { mode: 'page' }`, `Display menu`) are both in the new text, and the `must_not_contain` entries are absent. - `.changeset/29110-record-page-skill-split-retired.md`: `@objectstack/skills` patch (`skills/` ships in that package's `files`). Other skill text: a grep of `skills/` for "split beside", "beside the list", "Open records" and "split pane" found only these two files. No other skill text changes. ## Tests No ui test is owed (text only). The skill gates the repo derives for this diff are listed under Verification. ## Acceptance notes - `skills/` line readings. Changed file: `record-page.md` 65 lines before, 65 after (3981 bytes before, 3982 after; 996 tokens before and after, ceiling 996). The eval file is an eval fixture, measured and not ratcheted: 1899 bytes before, 1972 after. Whole package (sum of every `SKILL.md`): 4550 lines before and after; no `SKILL.md` is touched. - The rule file sits at its token ceiling, so the new words were paid for inside the same sentence; no ceiling moved. ## Verification Gates derived by `node scripts/pm/dispatch-gates.mjs --commands --repo objectstack-ai/objectstack` (43 families), run on head d0c28e8 and reconciled with `--ran`: 40 exit 0, 3 NOT MEASURED. Head eaef3b0 only adds a merge of `origin/main` that touches no `skills/` file; `check-skills-token-ratchet` re-ran green on it. <details><summary>Gate readings</summary> - `node scripts/check-skills-token-ratchet.mjs` exit 0 (record-page.md 996 tokens, ceiling 996) and `--self-test` exit 0. - `pnpm --filter @objectstack/lint run check:doc-formula-expressions` exit 0, after building `@objectstack/formula` and `@objectstack/lint` (its first run exited 3 on that prerequisite). - `node scripts/check-sdui-manifest.mjs` exit 0. - NOT MEASURED (exit 3, prerequisite not met: they read every package's `dist`, which needs a full `pnpm build`; this diff touches no package code): `check:dts-closure`, `check:dual-build-cjs-loads`, `check:lean-entry-closure`. CI runs them. - Every other derived family exit 0 (closing-keyword parity, changeset no-major, ADR-0087 registration, empty changeset, skill compatibility, skill frame sync, skill identifier liveness, nul bytes, doc authoring and the rest). </details> --- _Generated by [Claude Code](https://claude.ai/code/session_01QsR2jT7tQShSRWpBCBAgea)_ --------- Co-authored-by: Claude <noreply@anthropic.com>
1 parent 18a7f60 commit 5a2bdf9

3 files changed

Lines changed: 15 additions & 5 deletions

File tree

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
'@objectstack/skills': patch
3+
---
4+
5+
docs(skills): the record-page rule names drawer and full page as the reader's only Open records choices
6+
7+
Clause-②: no
8+
Metadata-protocol: none
9+
10+
The console retired the split pane beside the list: a list record opens in the drawer (the default) or as the full page, and the Display menu's Open records offers those two only. `skills/objectstack-ui/rules/record-page.md` rule 6 still taught "split beside the list — the default — or drawer, or full page", so an agent reading it told authors that records open beside the list and offered a choice that no longer exists. Rule 6 now names the two choices and says the split beside the list is retired; the drawer's dragged width and ⤢ stay reader preferences. Eval 2's expected answer says the same: a pane beside the list is no longer offered, nothing is authored for it, and the contract object keeps `navigation: { mode: 'page' }`.

‎skills/objectstack-ui/evals/record-page.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
{
2222
"id": 2,
2323
"prompt": "Contracts should open as a full page, not the side drawer. Reps also keep asking for records to open beside the list — add that to the contract object too.",
24-
"expected_output": "One declaration: `navigation: { mode: 'page' }` on the contract list view. The pane beside the list is each reader's own choice in the list's Display menu (Open records: split, drawer or full page), kept in the browser and offered for drawer-mode objects only, so nothing is authored for it; `split`, `modal` and `popover` were removed in @objectstack/spec 18.3.0 and are refused.",
24+
"expected_output": "One declaration: `navigation: { mode: 'page' }` on the contract list view. A pane beside the list is no longer offered: the split pane is retired. How a record opens is each reader's own choice in the list's Display menu (Open records: drawer, the default, or full page), kept in the browser and offered for drawer-mode objects only, so nothing is authored for it; `split`, `modal` and `popover` were removed in @objectstack/spec 18.3.0 and are refused.",
2525
"files": [],
2626
"assertions": {
2727
"must_contain": [

‎skills/objectstack-ui/rules/record-page.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -45,10 +45,10 @@ record should open as the full page (`new_window`, `none` are the other members)
4545
D2) and are refused with their fix. Field count never decides; a phone always pages.
4646

4747
**6 · The reader's own choices are not metadata.** ⛔ Never author these: the
48-
Display menu's **Open records** (split beside the list — the default — or drawer,
49-
or full page; offered for a drawer-mode object only), the ⊟ right-column switch
50-
(`⌘⇧,`, per object), the related panels' order and hidden set (⠿ drag, ⌥↑ / ⌥↓,
51-
per user × object), the pane's dragged width and ⤢. They live in the console's
48+
Display menu's **Open records** (drawer — the default — or full page, for a
49+
drawer-mode object; the split beside the list is retired), the ⊟ right-column
50+
switch (`⌘⇧,`, per object), the related panels' order and hidden set (⠿ drag,
51+
⌥↑ / ⌥↓, per user × object), the drawer's dragged width and ⤢. They live in the console's
5252
preference store, never in the object; on `navigation` only the `size` bucket
5353
(`sm`…`full`) nudges the drawer's starting width (`width` / `drawerWidth` deprecated).
5454

0 commit comments

Comments
 (0)