SuperAPI AI 工具集

hns-oss-docs-verify

通用与其它

查看项目

更新于 10-16 06:48

技能介绍

用途:这是 oss-docs 文档的执行式退出闸门,每位专家在返回前必须运行。所有检查均为只读,技能不会提交或推送代码。

主要检查:一、构建干净——cd docs-site && hugo --minify --gc 需退出码为 0 且无 WARN/ERROR,并确认 docs-site/public/sitemap.xml 存在。二、URL 黑名单——grep 检查 docs-site/content 与 README*.md 中是否出现失效域名,仅 adk.mo.ai.kr 有效。三、Mermaid 方向——禁止 flowchart LR/graph LR/RL,仅允许 TD/TB。四、四语言一致性——每个 ko 页面需有 en/ja/zh 对应文件;并逐页比较 H2 及更深标题数量,采用基线棘轮机制:docs-site/.locale-parity-baseline 记录已分歧页面,出现基线外的新分歧即失败;README 四个文件的 ## 数量需一致。五、正文 emoji 扫描——正文 emoji 判失败,图标应使用 {{</* icon */>}},代码块与排版符号例外。六、版本同步——版本展示须等于 hugo.toml 的 version,历史引用不算展示,releaseDate 需随版本一同更新。

评分映射:locale-parity、build-clean、version-sync 为 must_pass,阈值 1.0;style-compliance 阈值 0.95;content-fidelity 阈值 0.9。任一 must_pass 维度低于阈值将阻断结果(must_pass_ok: false),需修复后重新验证。注意 docs-i18n-check.sh 与 gen_menu.py 并不存在,不得调用。