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 个块的标题属于独立的内容改动,需要逐个判断该起什么标题,而不是机械补一个词。
解开需要做的
- 给这 40 个块各拟一个结论式的名词短语标题(与 Phase 7、Phase 8 新增的 33 个块同规格)
- 在
scripts/check-container-length.sh 里加标题校验:开启行 ^::: ?<type> 之后必须还有非空内容
- 该校验加进
docs-ci.yml 的 container-length job 之后,跑一次红绿演练确认无标题块真的会红
相关
- 该门禁的落地见
#44
AGENTS.md 里那段自检脚本已改为指向 scripts/check-container-length.sh,脚本的能力边界目前没有在 tracked 文件里写明,做这件事时一并补上
AGENTS.md:77对:::容器块有两条要求:带标题,且正文一到三句。Phase 8 落地的scripts/check-container-length.sh只校验后一条,前一条没有任何机械检查。现状
全站 40 个容器块没有标题(
^::: ?(tip|info|warning|danger)$形式):这些块渲染出来是一个只有类型色块、没有小标题的提示框。规范要求它们带标题,但没人会因为漏写而被拦下。
为什么 Phase 8 没有一并做
把标题校验接进那道阻塞门禁,
master会立刻变红 40 处。Phase 8 的范围是长度口径,一次改 40 个块的标题属于独立的内容改动,需要逐个判断该起什么标题,而不是机械补一个词。解开需要做的
scripts/check-container-length.sh里加标题校验:开启行^::: ?<type>之后必须还有非空内容docs-ci.yml的container-lengthjob 之后,跑一次红绿演练确认无标题块真的会红相关
#44AGENTS.md里那段自检脚本已改为指向scripts/check-container-length.sh,脚本的能力边界目前没有在 tracked 文件里写明,做这件事时一并补上