Skip to content

容器块标题校验缺位:门禁只管长度,全站 40 个无标题容器无人拦 #46

Description

@wisdommen

AGENTS.md:77 对 ::: 容器块有两条要求:带标题,且正文一到三句。Phase 8 落地的 scripts/check-container-length.sh 只校验后一条,前一条没有任何机械检查。

现状

全站 40 个容器块没有标题(^::: ?(tip|info|warning|danger)$ 形式):

grep -rhoE '^::: ?(tip|info|warning|danger)[[:space:]]*$' docs/src --include='*.md' | wc -l
40

这些块渲染出来是一个只有类型色块、没有小标题的提示框。规范要求它们带标题,但没人会因为漏写而被拦下。

为什么 Phase 8 没有一并做

把标题校验接进那道阻塞门禁,master 会立刻变红 40 处。Phase 8 的范围是长度口径,一次改 40 个块的标题属于独立的内容改动,需要逐个判断该起什么标题,而不是机械补一个词。

解开需要做的

  1. 给这 40 个块各拟一个结论式的名词短语标题(与 Phase 7、Phase 8 新增的 33 个块同规格)
  2. 在 scripts/check-container-length.sh 里加标题校验:开启行 ^::: ?<type> 之后必须还有非空内容
  3. 该校验加进 docs-ci.yml 的 container-length job 之后,跑一次红绿演练确认无标题块真的会红

相关

  • 该门禁的落地见 #44
  • AGENTS.md 里那段自检脚本已改为指向 scripts/check-container-length.sh,脚本的能力边界目前没有在 tracked 文件里写明,做这件事时一并补上

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions