用途:核对英文文档是否符合 writing-guides/formatting-guide.md 的全部规则。机械性规则由脚本 check-format-en.py 执行,需判断的规则通过阅读文件检查。
使用方式:先确定待检查文件,默认取当前评审中的文件,可通过 git diff --name-only、git diff --cached --name-only 以及 git status --porcelain 中 ?? 开头的未跟踪文件获取,筛选 en/ 下的 .mdx 与 .md;未检测到文件时询问用户。随后运行:python3 .claude/skills/dify-docs-format-check-en/check-format-en.py <file> [<file> ...]。
主要能力:脚本检查 frontmatter(缺 title、description 句末句号、引号使用、闭合 --- 后空行)、标题(尾随 #、前后空行、跳级、-ing 动词开头)、加粗斜体、列表(* 项目符号、空行、缩进)、代码块(语言标签、空行)、链接(click here、http、内部链接前缀)、图片(原始 img 标签、alt 文本、文件名规范)、Mintlify 组件、UI 元素引用、空行与标点等规则。模型审阅标题大小写、加粗与强调、列表类型与句号一致性、链接文本、图片 alt 与说明、表格对齐等。
输出:按文件分组列出确定性违规与判断性发现,并给出通过项。
限制:只读审计,不修改任何文件;脚本可能误报,需人工确认。