Skip to content

Commit 67ea914

Browse files
committed
docs(pm-dispatch): 域表拆分 domain:spec-surface —— 接受面判据、三席分界、产物随源走与卡点自报
维护者 2026-08-07 批准。domain:spec 一分为二:spec(语义面,接受面变化)/ spec-surface(文本面,校验不变量卡)。条款含:anchoring rule 的一包两席显式 例外与机械判据、反向红线(接受面改动不论大小归协议席)、与 spec-tooling (#5163)的机器/文本分界及 #6146×#6290 分治先例、产物随源走 + 同树重生成 串行(#4675 四步)、三个卡点自报信号、存量迁移与 sweep-first 运行模式。 座位贴 #6298 同批新立(⏳ 待认领)。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011M7UwH25Unfi73UHim7ajY
1 parent a7e7851 commit 67ea914

1 file changed

Lines changed: 32 additions & 1 deletion

File tree

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

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -581,7 +581,8 @@ file the fix touches, you have not triaged it yet, and it is not labelable.
581581
| `domain:services` | `packages/services/*``packages/connectors/*``packages/triggers/*`(flow 触发器)、`packages/plugins/plugin-approvals``plugin-webhooks``plugin-email``plugin-reports``embedder-openai``knowledge-memory``knowledge-ragflow` |
582582
| `domain:identity` | `packages/plugins/plugin-auth``plugin-security``plugin-sharing``plugin-audit` |
583583
| `domain:devx` | `packages/lint``packages/sdui-parser`(仅 lint 消费)、`skills/**``content/docs/**``apps/docs``scripts/`(门禁类) |
584-
| `domain:spec` | `packages/spec` 及其生成物(现 spec 车道不变) |
584+
| `domain:spec` | `packages/spec`**语义面**:schema 形状、`contracts/**`、退役的行为半边、strictness 台账 —— 判据是**接受面变化**,见下「`spec` 一分为二」 |
585+
| `domain:spec-surface` | `packages/spec`**文本面**:describe/JSDoc/墓碑迁移散文/错误 guidance 与 alias 表 —— 校验不变量卡,changeset 恒 patch,见下「`spec` 一分为二」 |
585586
| `domain:cli` | `packages/cli``runtime``verify``qa``types``packages/rest``packages/mcp``packages/observability``packages/client``packages/client-react`(REST 线协议 SDK)、`packages/cloud-connection``packages/create-objectstack``packages/adapters/*``packages/plugins/plugin-hono-server``plugin-dev` |
586587
| (无固定归属,按落点分诊) | `packages/apps/*`(`setup` / `studio` / `account`)、`packages/console``examples/*` —— 见下,**这一行是显式点名,不是遗漏** |
587588

@@ -620,6 +621,36 @@ objectql + metadata\* + platform-objects + core + formula + 全部 `driver-*`,
620621
照抄上表(维护者 2026-08-05 对 `driver-memory` / `driver-mongodb` 族的投入
621622
冻结指令锚在 `drivers` 那一行,`formula` / `driver-sql` 不受影响)。
622623

624+
**`spec` 一分为二(维护者 2026-08-07 批准,座位贴 #6298)。**`domain:spec`
625+
同时覆盖「改接受面」与「改契约自述文本」两类节律完全不同的活:前者量小、
626+
风险高、要吃版本窗口裁决;后者量大、机械、天然适合 sweep 打包 —— 混在一席,
627+
文本债持续积压(truth-sweep 审计开采一天可灌 5-10 张)。切分纪律:
628+
629+
- **判据是接受面,不是包、不是 diff 大小。** 这是 anchoring rule 在
630+
`packages/spec` 内的**显式例外**:一包两席,按「合法元数据集合变没变」分派 ——
631+
改动前能过校验的输入,改动后逐字节仍然同判 ⇒ `spec-surface`;否则 `spec`
632+
该判据与包归属同样机械(分诊读 diff 落点:语义行 vs 纯文本行)。反向红线:
633+
**任何改变接受/拒绝行为的卡,不论多小,归 `domain:spec`**(#6245 size S,
634+
但把零校验放行改成 422 ⇒ 协议卡;#6235 只开一个 `visibleWhen` 键 ⇒ 协议卡)。
635+
- **`domain:spec-tooling`(#5163 程序卡,座位贴 #6018)的分界**:surface
636+
「契约自己说的话」(`packages/spec` 源内文本行),tooling 改「围着契约转的
637+
机器」(门禁/生成器/lint 与 docs 手写页;其席位范围 ⛔ 不碰
638+
`packages/spec/src/**/*.zod.ts`,与 surface 天然无交集)。同一缺陷两半分治的
639+
先例:#6146(文档教了一个求值面从未绑定的根 —— surface)与 #6290(lint 一边
640+
宣告该根合法一边拒收、还附错误修法 —— tooling 面)。
641+
- **产物随源走**:describe/JSDoc 改动会重生成 `content/docs/references/**`
642+
manifest 的 description 字段 —— 产物变更归触发它的**源 PR**(`check:generated`
643+
重生成提交,⛔ 手改);同一生成树在飞重生成 >1 张时按 #4675 四步序串行
644+
(#6224 扣压处置即此形,记录在 #6018)。
645+
- **卡点自报**(座位职责,不等积压被感觉到):① 水位 —— 本车道 `pm:queue`
646+
连续 3 天 >15 张或平均滞留 >48h ⇒ 提频/加 batch/按本条款继续拆;② 同一
647+
references 树在飞重生成 PR >2 ⇒ 打包成一列发,不加席位;③ 分诊脉冲 ——
648+
单次审计灌入 20+ ⇒ 一次性 sweep 专项吃掉,不改常设结构。
649+
- **迁移**:存量带 `domain:spec` 的文本面 open issue 由**分诊座位**按上述判据
650+
一次性重标;拆分时已在飞的打包卡(sweep/工头)由原认领者跟完,不迁移。
651+
- **运行模式**:surface 席 sweep-first —— 一认领、一 PR、多单 `Fixes`,逐单
652+
清单复审、零 rider,把认领/PR/CI/验收的固定开销摊薄到 1/N(试点 #6243)。
653+
623654
**Label discipline —— 单一生产者。** `domain:*` 只由**分诊座位**在 backlog
624655
sweep(round loop step 0)产出,全仓唯一(rule 4)。**打标签 ≠ 认领**:分诊座位
625656
打完从不认领,执行座位读到从不重打。**未打标签的 issue 任何人都不得认领** ——

0 commit comments

Comments
 (0)