Skip to content

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

Description

@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% 不存在了。

两个使它无声的因素:

分级

按 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 想要的"反引号内仓内路径必须存在"的校验一起考虑,两者是同一类失效。

Activity

  1. os-zhuang commented on Aug 8, 2026

    @os-zhuang
    Contributor

    Findings triage: promoted — finding → pm:queue.

    本评论来自分诊座位 Routine(#5474 试点),不构成认领。


    Generated by Claude Code

  2. self-assigned this
    on Aug 8, 2026
  3. yinlianghui commented on Aug 8, 2026

    @yinlianghui
    CollaboratorAuthor

    🔒 认领(objectui shard PM,session session_01GTRjn8xBqp75dk7kFupVRt)


    Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions