本贴是 domain:spec-tooling(C 包,#5163 ) 座位的唯一权威登记。 座位贴协议(维护者 2026-08-06 批准,自 #4604 单正文座位表迁移而来):索引 = label:pm:seat,总入口 #4604 (指针页)。
单写手规则 :只有在任座位 PM 编辑本贴正文;接管/移交 = 改正文 + 一条审计评论(评论只作交接存档,不承载状态)。空缺争用时:动手前重拉正文、审计评论时间戳先到先得、写后回读。活性判定(惰性,无心跳,仅接管冲突时评估):Routine 座位查调度器(last_fired/next_run),会话座位查最近产出评论时间戳,>24h 无产出即可回收(改正文 + 审计评论)。
范围
协议工具链/门禁/生成器 + 配套 docs,清单以 #5163 卡片为准;文件面 scripts/**、packages/spec/scripts/**、packages/lint/**、content/docs/**(⛔ releases);⛔ 不碰 packages/spec/src/**/*.zod.ts 与 strictness 台账,确需触碰先在 #5163 留言协调
当前 PM(会话或 Routine ID)
会话 session_014wsZeReNTqiceBfLb5Pyf5(2026-08-06 15:2xZ 接管;维护者启动 /pm-dispatch spec-tooling。前任 session_01559M8FVm6W6vDLABL3jvdW 的 C 包收官帐见 #5163 的 15:0xZ 收尾评论,相位边界交接,非活性回收)
说明
运行参数 :batch:5(维护者 2026-08-06 15:3xZ 指示上调,原 3)。
车道现状(2026-08-06 15:3xZ,自 labels 重建) :domain:spec-tooling open 24 = pm:queue 未认领 11 / 在飞 4(#5837 + 本座位 3)/ finding 6 / 决策 2 / tracking 1(#5163 )。
spec 生成物按 category 分片：拆掉三个单体 ratchet 文件的合并队列串行税（维护者 2026-08-06 已拍板） #5837 session_011M7UwH25Unfi73UHim7ajY 跨域执行,14:41Z 认领;申报面 packages/spec/scripts/** + 三个热点生成物 + .gitattributes + docs build 读点)。窗口期内本座位只派与其实质不相交的单 ,判据:落点不读 authorable-surface.json / json-schema.manifest.json / api-surface.json(实测读者清单:build-schemas / build-docs / build-api-surface / build-spec-changes / check-generated / check-dual-source-exports / check-exported-any / lib/docs-import-surface / lib/renamed-defs + 根 scripts regen 系列)。第 1 轮在飞(3/5) :[spec] check:skill-examples 应拒绝 os:check 块内把入参标 any —— 标记了却零覆盖的空门 #5943 check-skill-examples.ts 拒 os:check 块 any 入参)、check:liveness 的 stale-evidence 检测只 ⚠ 不判红 —— ADR-0087 证据路径可以静默腐烂,且摘要行的 “N resolved” 数的是路径总数不是解析成功数 #5623 liveness/check-liveness.mts stale-evidence 升 ✗)、[docs-gen] 生成的 reference 把 retiredKey() 墓碑渲染成 any —— 嵌套两层时连 [REMOVED] 处方都没有,退役键读起来像自由槽 #5606 lib/format-type.ts 墓碑渲染 never 分支;PR 完成后停放 draft ,解除条件 = spec 生成物按 category 分片：拆掉三个单体 ratchet 文件的合并队列串行税（维护者 2026-08-06 已拍板） #5837 spec 生成物按 category 分片：拆掉三个单体 ratchet 文件的合并队列串行税（维护者 2026-08-06 已拍板） #5837 batch 5 的余下 2 个空位暂不可用 :队列其余 11 单全部实质相撞 —— build-schemas 族 build-schemas.ts 检查 (c) 的「墓碑已满 2 个 major」证明仍用叶名匹配 —— 无关簇的登记可以替一次退休提前起算 #5898 gen:schema 在锚点「领先于」解析基线时打印「trails the baseline … by 0 key(s)」——方向说反,信息为零 #5847 build-schemas.ts 的 zodShapeOf 对 z.preprocess 走错管道方向(#4488 已在 check-liveness 修过的同一个盲点) #5317 gen:schema rmSync 整个 json-schema/ 会顺手抹掉 gen:openapi 的产物,rest 的 openapi 路由测试随后 503 假红——check:generated 原地跑 build-schemas 也触发 #5371 gen:schema rmSync 整个 json-schema/ 会顺手抹掉 gen:openapi 的产物,rest 的 openapi 路由测试随后 503 假红——check:generated 原地跑 build-schemas 也触发 #5371 build-docs.ts --update-import-baseline 用 JSON.stringify 写原始字符,与仓内 ASCII 转义编码惯例冲突 —— 每次运行产生 ~275 行纯编码 churn 淹没真实变化 #5990 docs-gen: getCategoryTitle() 只给 UI/AI/API 大写,qa 渲染成 "Qa Protocol"(参考页标题 + meta.json + 根索引导航三处) #5853 docs-gen: 模块 JSDoc 按行拆成段落,跨行的行内代码跨度被切断 —— 5 张参考页正文露出裸反引号和 \{ 转义痕迹 #5553 两张公开参考页的正文被 #4001 的内部注释顶替(#3746 陷阱 1 已实际发生两次) #5059 参考文档生成器把数值字面量 z.literal(2) 渲染成带引号的 '2',数值型联合被记成字符串型 #5729 [docs-gen] 生成的 reference 把 retiredKey() 墓碑渲染成 any —— 嵌套两层时连 [REMOVED] 处方都没有,退役键读起来像自由槽 #5606 packages/spec/scripts/** 在任何 tsconfig 的 include 之外:9 个 vitest 测试文件 + 全部构建/gate 脚本无类型检查覆盖 #5475 spec 门禁盲区:可作者化 key 的「默认值 / 约束」变更不被任何 gate、tombstone 或 conversion 记录(#4650 / #4659 同族) #4666 spec 生成物按 category 分片：拆掉三个单体 ratchet 文件的合并队列串行税（维护者 2026-08-06 已拍板） #5837 [finding] DEBT ledger counts in check-type-check-coverage.mjs drift silently — @objectstack/metadata-protocol records 28, actually reports 63 #5278 ci(dx): DEBT/TEST_DEBT 台账数字改为每次重测的真棘轮 —— 实测 > 记录即红 (#5278) #5827 mergeable_state: dirty,裁决落地时先合 main 重校准再动。决策箱:sdui.manifest.json 的来源未定:声明一致性 ratchet 目前只在手工 pnpm sdui:manifest 时跑,CI 里从来不跑(#4690 的遗留决定) #5960 [finding] DEBT ledger counts in check-type-check-coverage.mjs drift silently — @objectstack/metadata-protocol records 28, actually reports 63 #5278 [finding] check:merge-driver 的两个 --self-test 没有任何 workflow 在跑 —— 合并驱动的规则回归只在有人手工跑根脚本时才现形 #6008 观察项:json-schema.manifest.json 没有 #4662 那样的「整文件规范形态」比对 —— 不改变键集的手编至今无人可见 #5972 [finding] TEST_DEBT 的 tests 字段是闸门自己已经算出来的数字,却手写在台账里 —— 19 条中 12 条已漂(runtime 记 66,实测 101) #5826 门测量的重合度 bridge 有残余假可达面:整形状由共享叶子组成的「小形状」恒为 1.0,任何阈值都排不掉 #5828 gen:docs 内联形状里的长枚举不省略,单个类型单元格可达约 900 字符(BulkActionDef.params 实例) #5340 SKILL.md compatibility 行无任何门禁对账 —— 声明的 spec 版本可与仓库实际版本无限期漂移(#5245 方案③拆出) #5331
实测纪律沉淀(承前任) :① auto-merge「全绿后挂载」三次静默不入队,处方 = disable→enable 翻转 + until-loop 队列分支确认(回包字段不作判据,重挂前先查未消化踢出);② 锚点防线三层闭合(#5358 何时写 / #5370 往哪写 / #4650 字节),检查 (c) 残洞在 #5898 ;③ 登记类门禁模板在树内(#5902 首创、#5971 复用:精确 key 集合 + 可粘贴处方 + (b2) 镜像 + 空表无回填证明)。
迁移注记:本贴自 #4604 座位表迁移(2026-08-06,经办 PM 会话 session_01GcjbQLUQKysMU9uXB34iyv);迁移时刻起本贴即该座位唯一权威,#4604 原行不再维护。
本贴是
domain:spec-tooling(C 包,#5163) 座位的唯一权威登记。 座位贴协议(维护者 2026-08-06 批准,自 #4604 单正文座位表迁移而来):索引 =label:pm:seat,总入口 #4604(指针页)。单写手规则:只有在任座位 PM 编辑本贴正文;接管/移交 = 改正文 + 一条审计评论(评论只作交接存档,不承载状态)。空缺争用时:动手前重拉正文、审计评论时间戳先到先得、写后回读。活性判定(惰性,无心跳,仅接管冲突时评估):Routine 座位查调度器(last_fired/next_run),会话座位查最近产出评论时间戳,>24h 无产出即可回收(改正文 + 审计评论)。
范围
协议工具链/门禁/生成器 + 配套 docs,清单以 #5163 卡片为准;文件面
scripts/**、packages/spec/scripts/**、packages/lint/**、content/docs/**(⛔ releases);⛔ 不碰packages/spec/src/**/*.zod.ts与 strictness 台账,确需触碰先在 #5163 留言协调当前 PM(会话或 Routine ID)
会话
session_014wsZeReNTqiceBfLb5Pyf5(2026-08-06 15:2xZ 接管;维护者启动/pm-dispatch spec-tooling。前任session_01559M8FVm6W6vDLABL3jvdW的 C 包收官帐见 #5163 的 15:0xZ 收尾评论,相位边界交接,非活性回收)说明
运行参数:
batch:5(维护者 2026-08-06 15:3xZ 指示上调,原 3)。车道现状(2026-08-06 15:3xZ,自 labels 重建):
domain:spec-toolingopen 24 = pm:queue 未认领 11 / 在飞 4(#5837 + 本座位 3)/ finding 6 / 决策 2 / tracking 1(#5163)。session_011M7UwH25Unfi73UHim7ajY跨域执行,14:41Z 认领;申报面packages/spec/scripts/**+ 三个热点生成物 +.gitattributes+ docs build 读点)。窗口期内本座位只派与其实质不相交的单,判据:落点不读authorable-surface.json/json-schema.manifest.json/api-surface.json(实测读者清单:build-schemas / build-docs / build-api-surface / build-spec-changes / check-generated / check-dual-source-exports / check-exported-any / lib/docs-import-surface / lib/renamed-defs + 根 scripts regen 系列)。check:skill-examples应拒绝 os:check 块内把入参标any—— 标记了却零覆盖的空门 #5943(check-skill-examples.ts拒 os:check 块any入参)、check:liveness的 stale-evidence 检测只 ⚠ 不判红 —— ADR-0087 证据路径可以静默腐烂,且摘要行的 “N resolved” 数的是路径总数不是解析成功数 #5623(liveness/check-liveness.mtsstale-evidence 升 ✗)、[docs-gen] 生成的 reference 把retiredKey()墓碑渲染成any—— 嵌套两层时连[REMOVED]处方都没有,退役键读起来像自由槽 #5606(lib/format-type.ts墓碑渲染never分支;PR 完成后停放 draft,解除条件 = spec 生成物按 category 分片：拆掉三个单体 ratchet 文件的合并队列串行税（维护者 2026-08-06 已拍板） #5837 落地 + spec 窗口解除,届时重生成 references 后转 ready)。三单代码面均不读三生成物,窗口协调评论在 spec 生成物按 category 分片：拆掉三个单体 ratchet 文件的合并队列串行税（维护者 2026-08-06 已拍板） #5837。build-schemas.ts的zodShapeOf对z.preprocess走错管道方向(#4488 已在 check-liveness 修过的同一个盲点) #5317 /gen:schemarmSync 整个json-schema/会顺手抹掉gen:openapi的产物,rest 的 openapi 路由测试随后 503 假红——check:generated原地跑 build-schemas 也触发 #5371(gen:schemarmSync 整个json-schema/会顺手抹掉gen:openapi的产物,rest 的 openapi 路由测试随后 503 假红——check:generated原地跑 build-schemas 也触发 #5371 前提被分片直接改变)、build-docs 族build-docs.ts --update-import-baseline用 JSON.stringify 写原始字符,与仓内 ASCII 转义编码惯例冲突 —— 每次运行产生 ~275 行纯编码 churn 淹没真实变化 #5990 / docs-gen:getCategoryTitle()只给 UI/AI/API 大写,qa渲染成 "Qa Protocol"(参考页标题 + meta.json + 根索引导航三处) #5853 / docs-gen: 模块 JSDoc 按行拆成段落,跨行的行内代码跨度被切断 —— 5 张参考页正文露出裸反引号和\{转义痕迹 #5553 / 两张公开参考页的正文被 #4001 的内部注释顶替(#3746 陷阱 1 已实际发生两次) #5059、同管线串行的 参考文档生成器把数值字面量 z.literal(2) 渲染成带引号的 '2',数值型联合被记成字符串型 #5729(让行 [docs-gen] 生成的 reference 把retiredKey()墓碑渲染成any—— 嵌套两层时连[REMOVED]处方都没有,退役键读起来像自由槽 #5606,备注已记该单)、横跨全改写面的packages/spec/scripts/**在任何 tsconfig 的 include 之外:9 个 vitest 测试文件 + 全部构建/gate 脚本无类型检查覆盖 #5475、design-heavy 的 spec 门禁盲区:可作者化 key 的「默认值 / 约束」变更不被任何 gate、tombstone 或 conversion 记录(#4650 / #4659 同族) #4666。spec 生成物按 category 分片：拆掉三个单体 ratchet 文件的合并队列串行税（维护者 2026-08-06 已拍板） #5837 落地即解除窗口:逐单重新定价后立刻补满 5 个在飞。mergeable_state: dirty,裁决落地时先合 main 重校准再动。pnpm sdui:manifest时跑,CI 里从来不跑(#4690 的遗留决定) #5960、[finding] DEBT ledger counts in check-type-check-coverage.mjs drift silently — @objectstack/metadata-protocol records 28, actually reports 63 #5278;findings 待分诊轮:[finding]check:merge-driver的两个 --self-test 没有任何 workflow 在跑 —— 合并驱动的规则回归只在有人手工跑根脚本时才现形 #6008 / 观察项:json-schema.manifest.json 没有 #4662 那样的「整文件规范形态」比对 —— 不改变键集的手编至今无人可见 #5972 / [finding] TEST_DEBT 的tests字段是闸门自己已经算出来的数字,却手写在台账里 —— 19 条中 12 条已漂(runtime 记 66,实测 101) #5826 / 门测量的重合度 bridge 有残余假可达面:整形状由共享叶子组成的「小形状」恒为 1.0,任何阈值都排不掉 #5828 / gen:docs 内联形状里的长枚举不省略,单个类型单元格可达约 900 字符(BulkActionDef.params 实例) #5340 / SKILL.mdcompatibility行无任何门禁对账 —— 声明的 spec 版本可与仓库实际版本无限期漂移(#5245 方案③拆出) #5331。实测纪律沉淀(承前任):① auto-merge「全绿后挂载」三次静默不入队,处方 = disable→enable 翻转 + until-loop 队列分支确认(回包字段不作判据,重挂前先查未消化踢出);② 锚点防线三层闭合(#5358 何时写 / #5370 往哪写 / #4650 字节),检查 (c) 残洞在 #5898;③ 登记类门禁模板在树内(#5902 首创、#5971 复用:精确 key 集合 + 可粘贴处方 + (b2) 镜像 + 空表无回填证明)。
迁移注记:本贴自 #4604 座位表迁移(2026-08-06,经办 PM 会话
session_01GcjbQLUQKysMU9uXB34iyv);迁移时刻起本贴即该座位唯一权威,#4604 原行不再维护。