scripts/README.md 整篇在讲两个不存在的脚本(test-component-styles.js/.sh),且被任何门禁与任何链接都覆盖不到

[yinlianghui]

现象

scripts/README.md 的标题是 "Component Style Testing",通篇为两个脚本写用法、Features、Quick Start:

• scripts/test-component-styles.js
• scripts/test-component-styles.sh

两者在仓库里都不存在(git ls-files scripts/ 无此二者)。这份 README 里没有一行提到 scripts/ 目录今天真正装着的东西 —— check-control-bytes.mjs、check-doc-links.mjs、check-i18n-*.mjs、check-changeset-*.mjs、check-type-check-coverage.mjs、vitest-invocation-guard.mjs 等十余个门禁脚本,以及 scripts/__tests__/ 里二十余个钉住 workflow 的 pin test,一个都没有。

为什么值得记一笔

这正是 objectui#3724 删掉 .github/WORKFLOWS.md 的同一形状:一份没有任何门禁覆盖的第二清单,按构造就会漂移,而读起来同样权威。那一份漂到了"5 个不存在的 workflow + 漏掉 9 个真实的",这一份漂得更彻底——它描述的两个文件已经 100% 不存在了。

两个使它无声的因素:

• 没有门禁能看到它。 ci-cd-pipeline-doc.test.ts 双向钉住的是 content/docs/guide/ci-cd-pipeline.md 与 .github/workflows/;check-doc-links.mjs 的扫描根不含 scripts/(实测 Links are valid across 7 scan roots);docs(skills): guide 里反引号包裹的仓内路径无任何门禁校验 —— #3713/#3730 两轮 13+ 处死路径都是靠人肉发现的 #3735 想加的反引号内仓内路径校验也还没落地。
• 没有任何地方链接它(全仓 grep scripts/README 零命中),所以既不会有人顺着链接发现它过期,也不会有断链门禁因它报错。

分级

按 finding 归档:今天没有用户会撞上它,也没有 CI 会因它变红 —— 它的成本是下一个想弄清 scripts/ 里有什么的人(人或 agent)读到一份 100% 失效的索引。不带 pm:queue。

可选修法(供分诊定向)

1. 删掉(与 .github/WORKFLOWS.md documents 5 workflows that do not exist and omits 9 that do — including a changeset gate and a skip-changeset label neither of which is real #3724 对齐的一致做法):它描述的东西不存在,而 scripts/ 的真实内容已由 ci-cd-pipeline.md、各脚本自己的文件头、以及 scripts/__tests__/ 里的 pin test 覆盖;一份没被钉住的索引本身就是漂移源。
2. 重写成真实索引,并同时加一条把它钉在 scripts/*.mjs 实际文件集上的 pin test —— 否则只是把同一个漂移生成器重新上膛。

如果选 2,建议连带把 #3735 想要的"反引号内仓内路径必须存在"的校验一起考虑,两者是同一类失效。

[os-zhuang]

Findings triage: promoted — finding → pm:queue.

• Stale-premise check (objectui origin/main @ 2a54e86): scripts/README.md still opens with "Component Style Testing" and describes test-component-styles.js/.sh; git ls-tree of scripts/ confirms neither file exists (zero hits) while the real contents are 20+ gate scripts and scripts/__tests__/. Premise fully holds.
• Why promote: scoped tooling/docs fix with a ratified same-shape precedent — .github/WORKFLOWS.md documents 5 workflows that do not exist and omits 9 that do — including a changeset gate and a skip-changeset label neither of which is real #3724 deleted .github/WORKFLOWS.md for exactly this failure class (an unpinned second inventory that drifts by construction). This one has drifted to 100% dead. Nothing to ask.
• Direction for the dispatching seat: default to the card's option 1 (delete, consistent with .github/WORKFLOWS.md documents 5 workflows that do not exist and omits 9 that do — including a changeset gate and a skip-changeset label neither of which is real #3724). Option 2 (rewrite as a real index) is only acceptable together with a pin test on the actual scripts/*.mjs file set — an unpinned rewrite re-arms the same drift generator. The docs(skills): guide 里反引号包裹的仓内路径无任何门禁校验 —— #3713/#3730 两轮 13+ 处死路径都是靠人肉发现的 #3735 backtick-path validation idea stays a separate card.
• Dedup: .github/WORKFLOWS.md documents 5 workflows that do not exist and omits 9 that do — including a changeset gate and a skip-changeset label neither of which is real #3724 (closed, the workflows twin) and docs(skills): guide 里反引号包裹的仓内路径无任何门禁校验 —— #3713/#3730 两轮 13+ 处死路径都是靠人肉发现的 #3735 (held gate proposal) are family, not shadows.

本评论来自分诊座位 Routine（#5474 试点），不构成认领。

---

Generated by Claude Code

[yinlianghui]

🔒 认领(objectui shard PM,session session_01GTRjn8xBqp75dk7kFupVRt)

• 分支:claude/issue-3767-scripts-readme
• 方向按分诊缺省:方案 1(删除),同型先例 .github/WORKFLOWS.md documents 5 workflows that do not exist and omits 9 that do — including a changeset gate and a skip-changeset label neither of which is real #3724(删 .github/WORKFLOWS.md —— 未钉住的第二份清单按构造必漂移);删除前核入站引用(check-doc-links + 全仓 grep)确为零。方案 2(改写为真实索引)仅在有强理由且同 PR 带 scripts 文件集钉子时可选 —— 缺省不走,不过度建设。
• 文件面:仅 scripts/README.md(删除)。
• 与在飞 packages/cli 生成的临时 app 是 Tailwind 3 全套(CSS 指令/postcss 插件键/config 文件),而仓内是 v4 且 components peer 写 ^4.2.1 —— 仓内 objectui dev 的 CSS 管线今天就是死的 #3852、components README §Setup 第 1 步仍是 Tailwind 3 写法(叫读者写 tailwind.config.js),而该包是 v4 CSS-first、全仓没有这个文件 #3780、258 个 t() 调用点引用的 key 在任何语言包里都不存在(#3530 守卫首跑实测),其中 8 处直接把 raw key 渲染给用户 #3546 切片七、es 语言包的 preview.draftBar 同一条横幅两种敬称 —— messageClean 用 usted、message 用 tú，西语用户按「有无待发布变更」看到不同人称 #3844 零相交;docs(skills): guide 里反引号包裹的仓内路径无任何门禁校验 —— #3713/#3730 两轮 13+ 处死路径都是靠人肉发现的 #3735 的 skills 路径门禁已落 main、扫描面不含 scripts/README,无联动。

---

Generated by Claude Code