Skip to content

Rewrite the 维护者速读 as a four-line business brief (PR bodies and decision cards) #35298

Description

@objectstack-fleet

epic:#35205#1 · os-warren · session_01JQwxbYJqoPAoSpWTMpH1yq

Source: maintainer — Warren, 2026-11-19 in the objectstack priorities discussion thread: 02:54Z 「目前的维护者速读,写的其实不是很好,感觉很多废话,应该从业务的角度写。」; the thread proposed the four-line shape below; 02:55Z 「同意」. Order sheet: pm-orders/objectstack/maintainer-brief-rewrite-2026-11-19.md.

Filing gate: ③ a task the maintainer dispatched (his words above). Child of epic #35205. Reader: the objectstack seat that takes #35205's skill steps. Dedupe: open cards under #35205 mentioning 维护者速读 / maintainer brief — none; #35259 edits the same skill files, so this card waits for its PR.

Grade: p2 · area:fleet · Task · fleet text, no product surface

Blocked-by: #35259

维护者速读

  • 用户能看到什么变化:用户无感;你收到的 PR 和决定卡,最上面改成四句业务话。
  • 为什么做:你说现在的速读废话多,要从业务角度写。
  • 出错会怎样:只是写法变了,评审和 agent 要的细节都还在下面英文部分,可以直接撤回。
  • 要你做什么:规则 PR 出来后批一下。

What changes

The ## 维护者速读 block is for the maintainer only: at most four lines, one Chinese sentence each, in words a product owner reads. ⛔ No code names, file paths, commands, ruling letters, or bare card numbers (a card named there carries a short Chinese description).

PR body ## 维护者速读 (replaces today's six lines):

  1. 用户能看到什么变化 — who, where, before → after; internal tooling says 「用户无感」.
  2. 为什么做 — the epic it comes from (Chinese name), or whose problem it fixes.
  3. 出错会怎样 — who hits what, and whether it can simply be reverted.
  4. 要你做什么 — exactly one thing, or 「无」.

Decision card brief (needs-user-decision, the decision box):

  1. 问题 — the symptom a customer sees, who hits it, how often.
  2. One sentence per option — what the customer sees if it is picked, roughly how many PRs.
  3. The recommendation, with one reason.
  4. What happens if nobody decides.

Moves to the English part (for reviewers and agents; ⛔ not deleted): files to read first and risky hunks, the two-minute verification command, the four axes, the 四棱 block, the self-check line, confidence gaps, effort precedents.

Where

  • .claude/agents/os-dev.md (~L284–287, the six-line definition).
  • .claude/skills/pm-dispatch/SKILL.md (~L202 「六行」; ~L106 the Chinese four-channel wording).
  • .claude/skills/pm-dispatch/references/decision-analysis.md — 「落卡分析模板」 and 「四棱卡面块」: the brief goes on top in the four lines above; four axes / 四棱 / self-check move to the English analysis section. Add the worked example below.
  • references/filing-gate.md (~L18) and lanes/mobile.md (~L43): align the 「需要你做的」 wording.
  • Scripts: scripts/pm/check-half-states.mjs keys on the ## 维护者速读 heading only (H48 etc.) — heading unchanged, no change needed. If any script counts six lines or parses the 「先看」/「两分钟验证」 lines, change it and its tests. Align the TRIAGE sample in scripts/pm/post-stamped.mjs (~L5610).

Worked example (goes into decision-analysis.md)

#35101 (new app's menu label saved as translated text):

  • 问题:在中文界面下新建或编辑应用,菜单里自动生成的名字被存成中文;换成英文界面,菜单还是中文。
  • 选项:A 存原文,切换语言时菜单名跟着变,一个小 PR;B 维持现状。
  • 推荐 A:应用要给不同语言的人用。
  • 不定会怎样:中文用户建的应用,在其他语言下菜单一直是中文。

(The skill text itself carries no card number or dated quote — ID lint; strip the number from the example when it goes in.)

Done when

Activity

  1. added
    toolingFix lands in tooling, not a product package — enters pm:queue only with Unblocks: or a named surface
    pm:blockedBlocked by another issue/PR — body carries Blocked-by: #N
    domain:skillsDomain lane — seat card indexed by label:pm:seat
    on Nov 19, 2026
  2. objectstack-fleet commented on Nov 19, 2026

    @objectstack-fleet
    ContributorAuthor

    repo:objectstack#1 · os-warren · session_01JQwxbYHmpLgwQvpwmbGvLL

    Grade: p2 → p1 — the maintainer's manual grade (no triage or seat moves it).

    Source: Warren, 2026-11-19 in the objectstack cloud os project thread: 04:51Z 「哪几个没做的,改到 p1」 — the not-yet-started fleet skill cards #35259, #35298, #35215, #35229–#35232 and #35234–#35238; 04:52Z 「不是让你做」 — relabel only. State label, assignee and Blocked-by lines are unchanged; nobody claims the card by this comment.

  3. added
    priority:p1High: required for production / M2
    and removed on Nov 19, 2026
  4. objectstack-fleet commented on Nov 19, 2026

    @objectstack-fleet
    ContributorAuthor

    repo:objectstack#1 · os-warren · session_01JQwxbYHmpLgwQvpwmbGvLL

    Claim: PM loop round 1
    Session: session_01JQwxbYHmpLgwQvpwmbGvLL
    Account: os-warren
    Branch: claude/project-thread-rothb5
    Worktree: objectstack-issue-35259
    Domain: domain:skills
    Seat: repo:objectstack#1
    File surface: .claude/skills/pm-dispatch/SKILL.md, .claude/skills/pm-dispatch/references/**, .claude/agents/os-dev.md, scripts/pm/check-half-states.mjs, scripts/pm/ensure-pm-labels.sh, scripts/pm/post-stamped.mjs, scripts/pm/check-skill-line-ratchet.mjs (ceiling rows only), their self-tests (stop on breach; explain in the report)
    Container & model: L, mode:thread, model: CONTRACT_REVIEW_TIER — dispatch-gates --tier MANDATORY: '.claude/agents/os-dev.md' clause ① (protocol semantics), effort: xhigh (rule text; maintainer's effort ruling 2026-11-19 04:24Z)
    Clause-②: no
    Metadata-protocol: none
    Responsibility: n/a — not a defect card
    Thread-read: 7000116937
    Premise: holds
    Serial constraints cleared: folded family — #35259 (chain head), #35298, #35230 land as ONE PR on this branch, one commit and one Fixes line per card. Sibling card threads in flight at the same time: #35229 (ratchet re-based to bytes, scripts/pm/check-skill-line-ratchet.mjs) and #35234 (check-half-states.mjs H13); whichever lands second rebases. #35231 #35232 #35235 #35237 #35238 stay held until this PR merges (same files).

    Folded into the #35259 PR on the branch above, so the Blocked-by: #35259 wait is met by landing together.

    Source of the dispatch: Warren, 2026-11-19 in the objectstack cloud os project thread: 04:54Z 「那你还是直接派发吧」; 04:55Z 「为什么不能合并派发」.

  5. added
    pm:dispatchedDispatched to a dev agent by /pm-dispatch
    and removed
    pm:blockedBlocked by another issue/PR — body carries Blocked-by: #N
    on Nov 19, 2026
  6. objectstack-fleet commented on Nov 19, 2026

    @objectstack-fleet
    ContributorAuthor

    repo:objectstack#5 · os-bill · session_01Utp6CaAqjP52wVTzs99H5G

    Release: session_01JQwxbYHmpLgwQvpwmbGvLL (claim 7000287652, os-warren, seat repo:objectstack#1) · cross-account hand-off to seat repo:objectstack#5 · the claim moves below on the same branch
    Release source: who — seat 1's hand-off in mailbox #35216, comments 7000702066 and addendum 7000717499 (Warren 2026-11-19 05:27Z 「都提交代码,交接给 seat 5」); the maintainer's word — Bill 2026-11-19 05:32Z 「这些你都接手」; where — the objectstack seat 5 project thread.

    Claim: PM loop round 1 · area fleet-1 (lease:fleet-1) · 2026-11-19T05:40Z
    Session: session_01Utp6CaAqjP52wVTzs99H5G
    Account: os-bill
    Branch: claude/project-thread-rothb5
    Worktree: objectstack-issue-35259
    Domain: domain:skills
    Seat: repo:objectstack#5
    File surface: .claude/skills/pm-dispatch/SKILL.md, .claude/skills/pm-dispatch/references/**, .claude/agents/os-dev.md, scripts/pm/check-half-states.mjs, scripts/pm/ensure-pm-labels.sh, scripts/pm/close-cards.mjs (pm:blocking readers only), scripts/pm/post-stamped.mjs, scripts/pm/check-skill-line-ratchet.mjs (ceiling rows only), their self-tests; docs/NORTH-STAR.md (only the two passages of comments 6998207239 and 6998230415); .claude/skills/checklist-test/SKILL.md and .claude/skills/scenario-eval/SKILL.md (only the #35230 C18 passages) (stop on breach; explain in the report)
    Container & model: L, mode:subagent, model: CONTRACT_REVIEW_TIER — dispatch-gates --tier MANDATORY: '.claude/skills/pm-dispatch/SKILL.md' and '.claude/agents/os-dev.md' clause ① (protocol semantics), effort: xhigh (rule text; the maintainer's effort ruling quoted on this card, comment 6999656302)
    Clause-②: no
    Metadata-protocol: none
    Responsibility: n/a — not a defect card
    Thread-read: 7000287652
    Premise: holds
    Resume-from: claude/project-thread-rothb5@cbdd979f6a
    Serial constraints cleared: folded family — #35259 (chain head), #35298, #35230 land as ONE PR on this branch, one commit and one Fixes line per card. Sibling branches of the same area: #35229 (claude/project-thread-xtbyqx, ratchet file — this PR touches ceiling rows only), #35234 (claude/project-thread-qqi9ki, check-half-states H13 + triage-duties.md sweep lines), #35236 (PR #35337, pointer lines); whichever lands second rebases. Overlap check at claim on cbdd979f6a: origin/main clean, #35335 and #35337 clean; #34110 (idle since 2026-11-17, already conflicting with main) conflicts on references/triage-duties.md — the second to land resolves it. #35231 #35232 #35235 #35238 stay held until this PR merges (same files).
    Pre-claim lane: area:fleet / domain:skills — .claude/skills/pm-dispatch/**, .claude/agents/os-dev.md, scripts/pm/**; docs/NORTH-STAR.md is the maintainer's surface (Tier H)
    Pre-claim deps: #35207 closed completed; #35298's Blocked-by: #35259 is met by the fold; no other Blocked-by
    Prior rulings read: docs/adr/** grep pm:blocking → 0 hits (the Blocked-by hits in ADR-0058/0126/0144/0146/0149/0155 are product text, not fleet states); the rulings this PR transcribes are the maintainer's words quoted on #35259, #35298, #35230 and their scope comments; no conflicting record

    Folded into the #35259 PR on the branch above, so the Blocked-by: #35259 wait is met by landing together.

    Handover record: last pushed sha on claude/project-thread-rothb5 is cbdd979f6a (checkpoint commit, no PR). #35259 rule text is done (11 files); its scripts are left (drop the two pm:blocking checks, add the five checks with self-tests, retire pm:blocking from the label vocabulary, raise the skill line-ceiling map citing the ruling ids); #35298 and #35230 are not started.

  7. objectstack-fleet commented on Nov 19, 2026

    @objectstack-fleet
    ContributorAuthor

    repo:objectstack#5 · os-bill · session_01Utp6CbUb7TcZK1XUAddUmQ

    ACCEPT → PR #35385 (G1) · head 17eb8951 · 2026-11-19T10:03Z. Contract review PASS 7005275823, delta PASS 7005660650 (S1, S2 closed). Tier H (docs/NORTH-STAR.md): awaiting a maintainer merge (reviewers os-zhuang, hotlong); close-out here on MERGED.

  8. objectstack-fleet commented on Nov 19, 2026

    @objectstack-fleet
    ContributorAuthor

    repo:objectstack#5 · os-bill · session_01Utp6CaAqjP52wVTzs99H5G

    Done · 2026-11-19T10:27Z · landed by PR #35385 (merged a1b14cdff8), folded with #35259 on the maintainer's word quoted in the PR body.

    The maintainer brief is four Chinese business lines in both forms, and the four-axis analysis is in the English section. The PR brief in os-dev.md follows the same shape. Seat record: PR comment 7005858687.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

area:fleetdomain:skillsDomain lane — seat card indexed by label:pm:seatpriority:p1High: required for production / M2toolingFix lands in tooling, not a product package — enters pm:queue only with Unblocks: or a named surface

Type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions