grounded-copy

这篇文章原来的中文介绍里，有一句“一道适用于各类可读文本的文字风格门禁”。读到“门禁”，大概能猜到它会拦下一些东西。至于拦什么、为什么要拦、拦完以后文章会变成什么样，仍然需要往下找。一个教 AI 把话写清楚的项目，自己的介绍就让人费了一番力气。

grounded-copy 做的事可以直接说出来：它给 AI 一套写作规则，并提供一个程序，检查草稿里容易反复出现的套话。比如夸大的评价，或是借某个来历含糊的权威替一句话作担保。作者需要回到材料里，找到这句话究竟有什么依据，再决定怎么写。

不过，改到段落这一层，事情就细了。

一段话里该留下什么

原来的介绍还花了整整一段，逐项交代检查器对九种语言的覆盖程度。维护检查器的人当然需要知道这些。第一次点开项目介绍的人，读到这里，却要同时记住语言分类、规则数量和匹配方式，才能接着往下读。

这里先要做的，是决定这一段值得占用读者多少注意力。假如它只需说明“中文也在支持范围内”，一句话便足够。具体能查出什么、有什么遗漏，可以等读者需要时，再引向详细文档。删去细节以后，还要检查剩下的话是否准确；把适用条件也一并删掉，介绍就会变成误导。

grounded-copy 在 0.6.0 加入的中文段落审读，着重处理的就是这类问题。它要求先想清读者需要知道什么，再选材料。几项技术细节共同解释一件事时，可以把那件事直接说清楚。把每项细节各写成一个短句，读者仍然得把整份清单读完。

文档里有个很小的例子：一次更新修复了上传中断后重复提交的问题，开发过程中涉及分块编号、校验记录和重试队列。给用户的说明写“修复了上传中断后重复提交的问题”，就已经交代了结果。工程说明再展开处理过程。两种文章各有自己的读者，也各有该写到的地方。

中文还有一些更细微的毛病。相邻两句反复说同一个意思，主语走到半途换了，前一句还像正式报告，后一句忽然变得油滑。这些地方，读者未必会停下来分析，却会一点点失去读下去的耐心。现在的指导把它们列入审读范围，要求逐段判断。检查程序目前还识别不了这些问题。

写完以后，再读一遍

插件负责在对话中给 AI 提供规则，Python 程序负责检查保存下来的草稿。Claude Code 和 Codex 可以通过插件使用它，其他支持技能的工具可以加载同一份写作指导。日常回复和产品文案有各自的模式，需要保留原文措辞时，也可以关闭。

程序查出一个表达，接下来仍要读它所在的句子。程序给出通过的结果，也只说明没有匹配到现有规则。文章的事实是否可靠，段落是否有必要，读起来是否顺畅，都还需要另作判断。

安装方法和完整规则放在项目仓库。

回头看开头那句介绍，最费心的部分其实是取舍。把“文字风格门禁”换掉很容易；决定接下来该告诉读者哪一件事，需要重新想一遍自己为什么写这一段。这个项目的中文改进，也就从这里继续往下做。