#4255 把「台账 ↔ package.json」对上了。还剩另一本无人对账的账：ci.yml 的 generated paths filter 是每个门输入集合的手工副本
三次漂移在案，每次都是撞上了才发现、事后补一段注释而不是加一个门：
docs(site): restructure IA into module-first single sidebar #2584 [P3] Retire the three deprecated aliases — via the ADR-0087 D2 conversion layer, not by deleting the keys #3855 check:authorable-surface 恰好在会删 authorable key 的 PR 上休眠。packages/spec/json-schema.manifest.json 从来就没被 filter 覆盖过gen:schema silently drops PageTabsProps since #2967 — references regen would delete real docs #2978 json-schema/ 是 gitignore 的构建产物，所以这个 manifest 是「上次 emit 过哪些 schema」的唯一持久记录 。build-schemas.ts 的报错文案要求退役 schema 时「在同一个 PR 里从 manifest 删掉 key」——但只改 manifest 的 PR 不命中 filter 任何一条路径，跳过它自己的验证者 。
结构性观察 ：10 个门里已经有 6 个逃出 filter（check:docs、check:skill-refs、check:react-blocks、check:api-surface、check:exported-any、check:skill-examples），每次逃跑都留了一段注释说明 filter 辜负了它。这说明正确的终局不是「再加一本账去对第一本账」，而是收编剩余 4 个门、把 filter 整个删掉 ——消除重复知识优于给重复知识加对账。
成本已实测，不构成障碍 ：check:docs 步骤在 CI 里耗时 4 秒 ，而它 = gen:schema（跑完整的 build-schemas.ts）+ build-docs.ts --check。也就是说那个「可能很贵」的 check:authorable-surface 跑的是同一个脚本、同一个 job 已经在每个 PR 上付过这笔钱了。同 job 其余门：check:skill-refs 0s、check:react-blocks 1s。整个 typecheck job 5 分 03 秒，其中 3 分 15 秒是 workspace build。搬 4 个门约加 5–8 秒。
删除安全性 ：needs.filter.outputs.generated 只被该 job 自己的 if: 引用；且 lint.yml 的注释明写该 job "It is not required, either"，删掉不会卡住分支保护。
修法 ：把 check:skill-docs / check:spec-changes / check:upgrade-guide / check:authorable-surface 搬进 lint.yml 的无 filter required job，删掉 check-generated job 与 generated filter 及其 output，并更新所有指向它的陈述（lint.yml 注释、check-generated.ts 头注释、AGENTS.md）。
Refs #4255 , #2584 , #3855 , #2978 , #3883 , #3733
#4255 把「台账 ↔ package.json」对上了。还剩另一本无人对账的账：
ci.yml的generatedpaths filter 是每个门输入集合的手工副本，filter 自己的注释写着 "keep the two in lockstep"，但没有任何东西强制这句话。三次漂移在案，每次都是撞上了才发现、事后补一段注释而不是加一个门：
check:authorable-surface恰好在会删 authorable key 的 PR 上休眠。packages/spec/json-schema.manifest.json从来就没被 filter 覆盖过——它是 gen:schema silently drops PageTabsProps since #2967 — references regen would delete real docs #2978 的棘轮台账，而json-schema/是 gitignore 的构建产物，所以这个 manifest 是「上次 emit 过哪些 schema」的唯一持久记录。build-schemas.ts的报错文案要求退役 schema 时「在同一个 PR 里从 manifest 删掉 key」——但只改 manifest 的 PR 不命中 filter 任何一条路径，跳过它自己的验证者。结构性观察：10 个门里已经有 6 个逃出 filter（
check:docs、check:skill-refs、check:react-blocks、check:api-surface、check:exported-any、check:skill-examples），每次逃跑都留了一段注释说明 filter 辜负了它。这说明正确的终局不是「再加一本账去对第一本账」，而是收编剩余 4 个门、把 filter 整个删掉——消除重复知识优于给重复知识加对账。成本已实测，不构成障碍：
check:docs步骤在 CI 里耗时 4 秒，而它 =gen:schema（跑完整的build-schemas.ts）+build-docs.ts --check。也就是说那个「可能很贵」的check:authorable-surface跑的是同一个脚本、同一个 job 已经在每个 PR 上付过这笔钱了。同 job 其余门：check:skill-refs0s、check:react-blocks1s。整个 typecheck job 5 分 03 秒，其中 3 分 15 秒是 workspace build。搬 4 个门约加 5–8 秒。删除安全性：
needs.filter.outputs.generated只被该 job 自己的if:引用；且 lint.yml 的注释明写该 job "It is not required, either"，删掉不会卡住分支保护。修法：把
check:skill-docs/check:spec-changes/check:upgrade-guide/check:authorable-surface搬进 lint.yml 的无 filter required job，删掉check-generatedjob 与generatedfilter 及其 output，并更新所有指向它的陈述（lint.yml 注释、check-generated.ts头注释、AGENTS.md）。Refs #4255, #2584, #3855, #2978, #3883, #3733