From 2a149b3165cb29037bace0b2fa4c0b9bb79eb94b Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 5 Sep 2026 15:32:25 +0000 Subject: [PATCH] docs(pm-dispatch): governing-text step and protocol-baseline rule in the decision frame MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The decision-card frame searched only card comments and the director ledger for prior rulings, so rulings codified in a repo AGENTS.md section, an ADR, a spec docblock or a lint rule were invisible to both the filing seat and the director. Two rules, each written once per carrier in its register: - Governing text: every 落卡 and 呈报 carries a `Governing text:` item (the AGENTS.md section / ADR / spec docblock / lint rule that already constrains the option space, quoted with the grep that found it, or `none found` with the searches run); a card whose options contradict it is not a decision card; leaving the decision box cites it alongside the ruling id. - Protocol baseline: when the spec declares X and the code does Y, the default is code → spec; a protocol change is its own card, never a side option in a defect card. The presenter's first two lines on such a card are what the protocol declares and whether the card asks to change it. Line-neutral on SKILL.md (811) and decision-analysis.md (50) by compressing two adjacent rule pairs into one 120-byte line each; director.md +2 (74/77). Every written line is at most 119 bytes. Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox Co-authored-by: Claude --- .claude/skills/pm-dispatch/SKILL.md | 10 +++++----- .../skills/pm-dispatch/references/decision-analysis.md | 6 +++--- .../skills/pm-dispatch/references/lanes/director.md | 2 ++ 3 files changed, 10 insertions(+), 8 deletions(-) diff --git a/.claude/skills/pm-dispatch/SKILL.md b/.claude/skills/pm-dispatch/SKILL.md index a32af80219..906597f493 100644 --- a/.claude/skills/pm-dispatch/SKILL.md +++ b/.claude/skills/pm-dispatch/SKILL.md @@ -708,8 +708,7 @@ PM 的工作是循环:选卡 → 认领 → 派发 → 收集 → 复核 → 报 - 先过升级门槛:明显的问题直接修,大多数感觉像决定的不是决定。 - 只在至少一条成立时升级:选项在产品语义或公开契约形状上真实分歧且既有规范定不了。 -- 或者:修复需要破坏性/难回滚动作。 -- 其余都是 PM 的裁量:裁定、派发、给维护者否决窗口而非许可门。 +- 或修复需破坏性/难回滚动作;其余归 PM 裁量:裁定、派发、维护者否决窗口而非许可门。 - 具名不升级类(立即行动):恢复不变量的修复;技术任务间的顺序与依赖;验证策略。 - dev 的 `needs_decision` 经 PM 复核落进不升级类的,PM 直接答复不上传。 - 第三档:带前提的裁决,三件套缺一不可:① 裁决(选定路线)。 @@ -724,12 +723,13 @@ PM 的工作是循环:选卡 → 认领 → 派发 → 收集 → 复核 → 报 - 卡上每条前提行自带一条 re-check 命令,复升级时逐条跑,零命中/变形的就地改写或撤卡。 - ②:决策默认锚在所属 issue(分析发评论,中文;挂 `needs-user-decision`、退出活动队列)。 - 无自然锚才单开 `[Decision] <一句话>` 卡;分析模板见 `references/decision-analysis.md`。 -- ③:答复/代裁到手,裁决记录四件同笔。 -- 四件 = 鲜度门 / 状态转换同笔 / `Blocked-by:` 活性现验 / 条件已判即判。 +- 落卡与呈报必带 `Governing text:`(AGENTS.md/ADR/spec docblock/lint 规则);选项与之冲突者非决策卡。 +- 协议为基准:spec 与代码不一致默认改代码对齐;改协议单独立卡,⛔ 不作缺陷卡的选项。 +- ③:答复/代裁到手,四件同笔:鲜度门/状态转换同笔/`Blocked-by:` 活性现验/条件已判即判。 - 鲜度门 = 录前重读晚于正文最后编辑的评论;案例与机械两旗见 `references/dispatch-runbook.md`。 - 一条裁决已记录的权威载体 = 总监席每场收工的摘要台账(卡、权威、方向、状态转移)。 - 卡上裁决评论是详注,仍是执行与复核的第一落点。 -- 出决策箱须引一个同趟取回过的裁决 id,⛔ 时间戳加回忆不算引用。 +- 出决策箱须引同趟取回过的裁决 id 与 `Governing text:` 项,⛔ 时间戳加回忆不算引用。 **每个方案必须沿四条固定评估轴分析,这是决策分析的核心原则,不是可选项:** - **实际业务需求** — 它服务的是**真实存在的业务场景**, diff --git a/.claude/skills/pm-dispatch/references/decision-analysis.md b/.claude/skills/pm-dispatch/references/decision-analysis.md index 54a0bcbdab..dd5aa7bd00 100644 --- a/.claude/skills/pm-dispatch/references/decision-analysis.md +++ b/.claude/skills/pm-dispatch/references/decision-analysis.md @@ -5,8 +5,7 @@ ## 适用面 - 只约束 `needs-user-decision` 卡与决策箱讨论的四维分析。 -- 内部工具卡(dev 派发用)的四维照旧,⛔ 不强加行业类比。 -- 只适用新记录,存量分析 ⛔ 不回改。 +- 内部工具卡(dev 派发用)四维照旧,⛔ 不强加行业类比;只适用新记录,存量 ⛔ 不回改。 ## 常设决裁批流程 @@ -22,7 +21,8 @@ ## 落卡分析模板 -段落骨架:背景 / 带 re-check 命令的前提 / 具体问题 / 选项 / 推荐 / 相关单与 PR。正文六项: +段落骨架:背景 / Governing text(引文 + grep,或 none found + 检索式)/ 协议声明、是否改协议 / +带 re-check 命令的前提 / 具体问题 / 选项 / 推荐 / 相关单与 PR。正文六项: - 一句话问题:开头一句话说清冲突是什么,⛔ 不带实现名词,写客户看得见的症状。 - 选项 × 真实代价表:每选项一行,做什么 + 客户可感知的后果;有实测的注明实测。 diff --git a/.claude/skills/pm-dispatch/references/lanes/director.md b/.claude/skills/pm-dispatch/references/lanes/director.md index ed8b7cb996..a5568d0b40 100644 --- a/.claude/skills/pm-dispatch/references/lanes/director.md +++ b/.claude/skills/pm-dispatch/references/lanes/director.md @@ -43,6 +43,8 @@ issue 编号;机器判据恒英文,引文逐字不译。 - 决策收件箱(`needs-user-decision`)跨仓勤务:按基本原则批呈;一行回批即全链执行,裁后 四件原子执行不再请示;批间新到滚入下批,收件箱清零才收工;⛔ 不复活已退役的 汇总 issue（2026-08-19 裁定）。 +- 呈报前逐卡逐仓重跑 `git grep -n -iE 'TERMS' origin/main -- AGENTS.md docs/adr packages/spec/src`。 +- spec 之争前两行 = 协议原文(带文件)、是否改协议;改 ⇒ 重立协议卡,否则只议对齐。 - 代裁通道(分诊席或本席)硬门、置信门与人工地板见主文件「分诊座位职责」,⛔ 不另 抄;不达档 ⇒ 通道整体跳过、卡走维护者路径,恒安全。