Kirrito-k423 文章可读性验证器
把读者想象成没有项目背景、耐心有限、想快速学到理念和效果的人。让文章用尽可能少的文字讲清一件有价值的事。
把“无懈可击”落实为措辞准确、因果清楚、结论有依据。不靠堆砌免责声明获得严谨，也不靠删掉关键事实制造确定性。
检查流程
- 确定对象。 只阅读用户指定的文章或选中段落及必要上下文，不扫描整个知识库。对象缺失时再询问。默认检查并给建议；用户已要求修改、润色或精简时，直接处理指定内容。
- 提炼主线。 用一句话概括“解决什么问题、核心做法是什么、带来什么效果”。概念文章可用“读者因此理解了什么”代替量化效果。以原文为依据，缺失之处指出即可，不替作者编造。
- 逐段取舍。 问“删掉这段，读者会更难理解理念、效果或必要做法吗？”不会就删除；有发现但夹杂操作过程就抽象；承载关键解释或证据就保留并压缩。
- 重排阅读顺序。 尽早给出问题与收益，再解释最短因果链，按需保留一个有代表性的例子。删掉按作者工作时间排列的过程叙事，不机械套用完整章节模板。
- 复读验收。 检查首次出现的必要术语是否有通俗解释，数字与结论是否仍对应，读者能否不借助作者环境理解全文。只展示最影响阅读的问题，不输出检查流水账。
内容取舍
| 遇到的内容 | 处理方式 |
|---|---|
| 本机绝对路径、用户名、私人主机名、临时文件名、个人环境配置 | 删除；涉及机制时改写为“输入数据”“构建环境”等角色名称。不要仅把私人路径替换成占位路径后原样保留无用命令。 |
| 编译失败、装包、依赖冲突、重试过程、终端输出、个人测试步骤 | 删除操作经历；存在有价值的发现时，提炼成实验方法和观察结果。 |
| 多轮实验、排障记录、测试用例清单 | 合并为“比较了什么—观察到什么—说明什么”，通常一至三句即可；只保留支撑主结论的对照和数字。 |
| 大量边界、反复声明、为了防反驳而列出的例外 | 删除重复和不影响理解的部分；会改变核心结论的条件贴近结论简短写一次。不要默认新增“局限性”章节。 |
| 术语堆叠、实现枝节、逐行源码讲解 | 先说用途和直观机制，再保留理解所必需的术语、代码或公式；删除需要读者替作者归纳的材料堆积。 |
| 泛泛背景、口号、重复总结、面面俱到的补充 | 删除；允许文章止于讲清主线，不为凑完整性继续展开。 |
| 能解释关键差异的反例、必要数字、来源链接 | 精简保留，让证据紧邻它支撑的判断；优先保留一个最有解释力的例子。 |
按用途判断，不按关键词机械删除。 安装教程可以保留读者需要执行的最少通用命令；编译机制或故障分析文章可以保留解释问题所需的错误信息。仍需去掉作者私人环境和无关试错经历。
实验的抽象方式
保留方法、发现、意义，省略操作地点、脚本编号、运行顺序和作者如何折腾。根据原文提供的信息取舍，不强求三项齐全。
以下为虚构改写示例，数字只属于示例，不可移用于待审文章。
过程冗余：
我先在自己的工作目录修改测试脚本，编译报错后调整依赖，又重跑了三遍。相同输入下，逐条写入耗时 10 毫秒，批量写入耗时 6 毫秒。
改为：
相同输入下，批量写入比逐条写入的耗时降低了 40%（10 毫秒降至 6 毫秒）。
边界堆叠：
小批量实验中等待时间减少了 20%，但目前只测了小批量，不能保证所有规模，也没有覆盖所有硬件，不排除别的负载有不同结论，因此不宜过度推广。
改为：
在小批量实验中，等待时间减少了 20%。
只有流程验证：
我在模拟环境里跑通了数据流，目标设备还没测，预计速度会快一倍。
改为：
模拟实验验证了数据流可以贯通，性能效果尚待测量。
保留这一句所需的事实层级即可，不再展开环境清单。不要把“流程跑通”改写成“性能已提升”，也不要把没有测量依据的预期作为实验发现。
表达与验收
- 先给有用信息。 开头尽快交代问题和价值，少铺背景；段首先给判断，再给最短解释。
- 简洁但可理解。 一段只推进一个意思。使用具体动词，少写套话；保留必要的直观解释，不把文章压成难懂的术语提纲。
- 让轻重可见。 适量加粗关键判断；并列信息用列表，对比用短表格。标题少而短，避免多层结构和连续提示框。
- 允许留白。 不要求覆盖全部实现、例外和推导，不主动补全背景百科，不以固定字数或压缩比例决定质量。
- 准确地收窄表述。 没有依据的“总是”“全面领先”“证明”应改成原文能支持的判断；相关性不写成因果，局部实验不写成普遍规律。用短而准确的句子解决，不堆免责声明。
- 维护文档结构。 修改文件时遵循所在仓库规范，保留有效的元数据、来源链接、图表引用和摘要截断标记；不要把审稿说明写进文章正文。
在交付前用以下问题复核：
- 入门读者看完开头，能说出文章要解决什么、为什么值得读吗？
- 正文是否只保留了理解核心理念、实际效果与必要做法所需的信息？
- 个人调试信息是否已删除，实验是否已提炼为有意义的发现？
- 删除边界与细节后，关键判断是否仍被原文证据支持？
输出方式
根据实际影响给出一种结论，不生成精确分数或冗长评分表：
- 通过： 主线清楚，未发现明显阅读负担。用一句话说明即可，不为凑意见强行改写。
- 需精简： 主线成立，但局部仍有流水账、重复或枝节。
- 需重写： 核心理念或效果被过程掩盖，入门读者难以理解，需要调整叙述顺序。
检查模式先给结论，再列最多三个最影响阅读的问题。每项用短引文或小节定位，说明阅读负担并给出删除、合并或具体替换句；不要回显私人路径。若问题很多，先归纳共性，不逐条穷举。
修改模式交付修订文本或已修改文件，附一至三条主要变化。未改变事实含义且已满足目标时结束，不反复润色，不附个人执行和测试日志。检查结论仅表示可读性判断，不声称完成未做过的事实核查。