用途:检查改动过的中文与日文文档是否符合 writing-guides/formatting-guide.md、tools/translate/formatting-zh.md、tools/translate/formatting-ja.md 中的全部规则。机械规则由 linter 脚本执行,判断类规则由人工阅读文件检查。linter 会依据路径是否以 zh/ 或 ja/ 开头自动选择对应规则集。
使用方式:先审计整个文件而非仅差异。默认检查当前审阅中的文件,可通过 git diff --name-only、git diff --cached --name-only 以及 git status --porcelain 中 ?? 开头的未跟踪文件来检测,筛选 zh/ 或 ja/ 下的 .mdx 与 .md 文件;若未检测到文件,需询问用户要检查哪些文件。运行 linter:python3 .claude/skills/dify-docs-format-check-cjk/check-format-cjk.py <file> [<file> ...]。
主要能力:确定性检查覆盖共享结构规则(frontmatter、标题、列表、代码块、链接、图片、组件、标点等)、共享 CJK 规则(CJK 与拉丁字符间距、半角标点、加粗与链接间距、斜体、破折号、免责声明、跨语言链接)、标题规则及中文专属规则(省略号、全角斜杠、引号、范围连接号、百分号间距)和日文专属规则(全角数字/字母/空格、长句、ご前缀、标题句式、文体混用)。判断类检查涵盖可翻译元素(Tab 标题、图注与 alt、加粗 UI 标签、代码块内示例)、锚点翻译、中文与日文行文风格及翻译腔。
输出:按文件分组,列出确定性违规(行号、规则 ID、消息)、判断类发现(行号、问题描述、规则领域)与通过项。
限制:不得修改任何文件,属只读审计;确定性规则若明显为有意写法(如拉丁缩写中的半角逗号、引自外部来源的引号)需说明歧义交由用户判断;术语与 UI 标签校验以 terminology-check 技能为准,重叠时以后者为准;日文句长与文体混用为启发式检查,仅供人工复核,非确定性违规。