Seiso：面向 AI 生成文档的 Markdown 规范与检查工具

核心亮点

Seiso 用 Rust 写成，解决一个越来越普遍的问题：当文档由 AI 生成、却要同时给人类和智能体阅读时，格式混乱会让两边都很痛苦。它提供一套 Markdown 书写约定，并配套检查器自动把关，让"写给人"和"写给机器"的文档不再互相将就。

具体能力

Seiso 定义了文档结构、标题层级、代码块标注、 frontmatter 等约定，并通过命令行检查器扫描仓库，指出不符合规范的地方。它既能接入 CI 在提交时拦截，也能本地批量修正，把规范执行变成一行命令的事，而不是靠人工 code review 去盯格式。

技术细节

Rust 实现带来高速度与低资源占用，适合在大型仓库里频繁运行。检查规则围绕"可被机器稳定解析"设计——比如要求每个代码块标明语言、禁止歧义标题、统一链接写法，从而降低智能体误读概率，也让人扫读更省力，减少认知负担。

与竞品对比

相比通用 Markdown Linter（如 markdownlint），Seiso 的着眼点是 AI 协作场景下"人和智能体共读"的特殊需求，规则更偏向结构化与可解析性，而非纯排版美观，定位更贴近工程而非写作，是对新一代文档工作流的针对性回应。

适用场景

只要你的仓库里有 AI 生成的 README、接口文档、运维手册，Seiso 就能派上用场。它尤其适合多人协作、且有智能体参与检索与生成的团队，能把"文档质量"从主观感受变成可度量的门禁。

行业影响

随着 AI 大量参与文档编写，统一的机器可读规范会越来越重要。Seiso 给团队提供了一条低成本落地路径：让 AI 写、人审、智能体读，三者共享同一套纪律。说白了，它是 AI 时代文档质量的守门员。