Skip to content

Commit 3140345

Browse files
os-steveclaude
andauthored
docs(pm-dispatch): governing-text step and protocol-baseline rule in the decision frame (#15946)
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 <noreply@anthropic.com>
1 parent 098cbb7 commit 3140345

3 files changed

Lines changed: 12 additions & 12 deletions

File tree

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

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -709,8 +709,7 @@ PM 的工作是循环:选卡 → 认领 → 派发 → 收集 → 复核 → 报
709709

710710
- 先过升级门槛:明显的问题直接修,大多数感觉像决定的不是决定。
711711
- 只在至少一条成立时升级:选项在产品语义或公开契约形状上真实分歧且既有规范定不了。
712-
- 或者:修复需要破坏性/难回滚动作。
713-
- 其余都是 PM 的裁量:裁定、派发、给维护者否决窗口而非许可门。
712+
- 或修复需破坏性/难回滚动作;其余归 PM 裁量:裁定、派发、维护者否决窗口而非许可门。
714713
- 具名不升级类(立即行动):恢复不变量的修复;技术任务间的顺序与依赖;验证策略。
715714
- dev 的 `needs_decision` 经 PM 复核落进不升级类的,PM 直接答复不上传。
716715
- 第三档:带前提的裁决,三件套缺一不可:① 裁决(选定路线)。
@@ -725,12 +724,13 @@ PM 的工作是循环:选卡 → 认领 → 派发 → 收集 → 复核 → 报
725724
- 卡上每条前提行自带一条 re-check 命令,复升级时逐条跑,零命中/变形的就地改写或撤卡。
726725
- ②:决策默认锚在所属 issue(分析发评论,中文;挂 `needs-user-decision`、退出活动队列)。
727726
- 无自然锚才单开 `[Decision] <一句话>` 卡;分析模板见 `references/decision-analysis.md`
728-
- ③:答复/代裁到手,裁决记录四件同笔。
729-
- 四件 = 鲜度门 / 状态转换同笔 / `Blocked-by:` 活性现验 / 条件已判即判。
727+
- 落卡与呈报必带 `Governing text:`(AGENTS.md/ADR/spec docblock/lint 规则);选项与之冲突者非决策卡。
728+
- 协议为基准:spec 与代码不一致默认改代码对齐;改协议单独立卡,⛔ 不作缺陷卡的选项。
729+
- ③:答复/代裁到手,四件同笔:鲜度门/状态转换同笔/`Blocked-by:` 活性现验/条件已判即判。
730730
- 鲜度门 = 录前重读晚于正文最后编辑的评论;案例与机械两旗见 `references/dispatch-runbook.md`
731731
- 一条裁决已记录的权威载体 = 总监席每场收工的摘要台账(卡、权威、方向、状态转移)。
732732
- 卡上裁决评论是详注,仍是执行与复核的第一落点。
733-
- 出决策箱须引一个同趟取回过的裁决 id,⛔ 时间戳加回忆不算引用。
733+
- 出决策箱须引同趟取回过的裁决 id`Governing text:`,⛔ 时间戳加回忆不算引用。
734734
**每个方案必须沿四条固定评估轴分析,这是决策分析的核心原则,不是可选项:**
735735

736736
- **实际业务需求** — 它服务的是**真实存在的业务场景**,

.claude/skills/pm-dispatch/references/decision-analysis.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,7 @@
55
## 适用面
66

77
- 只约束 `needs-user-decision` 卡与决策箱讨论的四维分析。
8-
- 内部工具卡(dev 派发用)的四维照旧,⛔ 不强加行业类比。
9-
- 只适用新记录,存量分析 ⛔ 不回改。
8+
- 内部工具卡(dev 派发用)四维照旧,⛔ 不强加行业类比;只适用新记录,存量 ⛔ 不回改。
109

1110
## 常设决裁批流程
1211

@@ -22,7 +21,8 @@
2221

2322
## 落卡分析模板
2423

25-
段落骨架:背景 / 带 re-check 命令的前提 / 具体问题 / 选项 / 推荐 / 相关单与 PR。正文六项:
24+
段落骨架:背景 / Governing text(引文 + grep,或 none found + 检索式)/ 协议声明、是否改协议 /
25+
带 re-check 命令的前提 / 具体问题 / 选项 / 推荐 / 相关单与 PR。正文六项:
2626

2727
- 一句话问题:开头一句话说清冲突是什么,⛔ 不带实现名词,写客户看得见的症状。
2828
- 选项 × 真实代价表:每选项一行,做什么 + 客户可感知的后果;有实测的注明实测。

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,8 @@
4242
- 决策收件箱 `needs-user-decision` 跨仓勤务,按基本原则批呈。
4343
- 一行回批即全链执行,裁后四件原子执行不再请示。
4444
- 批间新到滚入下批,收件箱清零才收工;⛔ 不复活已退役的汇总 issue。
45+
- 呈报前逐卡逐仓重跑 `git grep -n -iE 'TERMS' origin/main -- AGENTS.md docs/adr packages/spec/src`
46+
- spec 之争前两行 = 协议原文(带文件)、是否改协议;改 ⇒ 重立协议卡,否则只议对齐。
4547
- 代裁通道(分诊席或本席)的硬门、置信门与人工地板见 SKILL.md 分诊座位职责,⛔ 不另抄。
4648
- 不达档 ⇒ 通道整体跳过,卡走维护者路径,恒安全。
4749

@@ -58,15 +60,13 @@
5860
- 检测双层、处置单席:车道轮报 sweep 只作早警,权威合并窗口在本席。
5961
- 每场召唤实跑 check-governed-merges,`--since-ref` 锚上一场记录的 tips。
6062
- 锚行住座位贴说明段;脚本零存储,自打印下一场参数,跑后新 tips 同笔记回。
61-
- INCOMPLETE(exit 2)照实报,⛔ 不作干净。
62-
- 清单并入决裁批次,一行一条认定 y 或 n。
63+
- INCOMPLETE(exit 2)照实报,⛔ 不作干净;清单并入决裁批次,一行一条认定 y 或 n。
6364
- 未认定条目 = 席位违规,同笔立 `needs-user-decision` 卡立案回滚,事后审计制。
6465
- 容器 403 归因逐条走 MCP 补齐。
6566
- ⛔ 不新增标签:枚举本地树推导零 API。⛔ 无 cron,节奏与停放同授权段。
6667

6768
## 与 skills 席的分界
6869

69-
- 改 skill、指令或治理文本的工作归 skills 席。
70-
- 出裁决、清复审标、清点待人工清单的勤务归本席。
70+
- 改 skill、指令或治理文本归 skills 席;出裁决、清复审标、清点待人工清单归本席。
7171
- 契约复核的放行归派发席席内,定时轮与本席降为可选事后审计,`../contract-review.md` 为准。
7272
- 机读保险丝照旧,不可协商。

0 commit comments

Comments
 (0)