doc-optimizer

name	doc-optimizer
description	对既有 Markdown 文档做结构化增强与可读性优化，保持原意与作者语气不变。触发于用户要求“润色 / 优化 / 重写文档但不改含义”时。

Doc Optimizer（文档优化器）

用于在 不改变原文事实与结论 的前提下，提升 Markdown 文档的结构、可读性和专业表达质量，并尽量保持用户既有写作风格。

触发时机

• 用户要求“优化 / 润色 / 重写”已有文档
• 用户明确要求“不改变原意、不遗漏信息”
• 用户希望“更易读、更美观、更有逻辑”的 Markdown 产出
• 需要在工程内将一次性文档优化方法沉淀为可复用规范

输入

• 原始 Markdown 文件路径（如 docs/*.md）
• 用户约束（如“不得修改表达内容”“保持本人风格”）
• 项目上下文（术语、模块名、变量名、业务边界）
• 若用户未显式提供完整上下文，需根据文章内容自行补充必要的工程上下文

表达约束

• 能压成一句的段落，就不要写成两三句。
• 只删冗余，不拿“补充说明”之名重复原意。
• 不主动改写成固定章节模板；原文怎么推进，就沿着原文推进。

执行步骤

1. 完整读取原文并抽取信息清单。

   • 按“背景、目标、方案、问题、结论”梳理所有信息点。
   • 记录专有名词、变量名、方法名、第三方库名，避免误改。
   • 将目标读者默认为“0 上下文读者”，识别哪些信息对陌生读者不充分。

2. 必要时先补齐工程上下文再改写。

   • 根据文章中出现的模块、流程、术语，自行了解并补齐最小必要背景。
   • 仅补充“理解当前内容所必需”的上下文，不扩展与主题无关的信息。

3. 做“信息守恒”校验后再改写。

   • 先列出原文必须保留的要点，再开始重排结构。
   • 对每一段改写，确保语义等价，不新增未经原文支持的结论。

4. 进行 Markdown 结构化增强。

   • 合理补齐标题层级（## / ###），形成清晰阅读路径。
   • 在适合位置使用行内代码（如 URI、dispatchServiceCall、USE_SHARED_DATABASE）。
   • 对关键结论、边界条件使用强调或引用块提升扫描效率。
   • 长段落拆分为短段和列表，避免信息堆叠。
   • 统一目标文章的基础排版规范（如中文与英文、中文与数字之间的空格；中英文标点混用时的可读性）。

5. 优化逻辑衔接与上下文可读性。

   • 产出结构必须严格遵循原文的逻辑关系与推进顺序，不得为了“更标准”而重排为固定模板。
   • 在不改含义前提下，补充最小必要上下文，保证 0 上下文读者也能准确理解。

6. 做风格一致性回归。

   • 保留第一人称叙述、原有语气强度、原有判断方式。
   • 避免“过度 AI 化”的措辞，确保读感仍像用户本人写作。
   • 句子能收短就收短，不用“为了显得完整”补废话。

7. 输出前自检。

   • 无信息遗漏、无事实偏移、无术语误替换。
   • Markdown 渲染层级正确，列表、引用、代码格式规范。

输出 / 质量门槛

• 输出为已优化的原文件（就地更新）
• 必须满足：
  • 信息守恒：原文要点 100% 保留
  • 语义等价：不改变立场、结论、边界
  • 上下文充分：0 上下文读者可独立理解关键术语、流程与结论
  • 结构清晰：读者可在 30 秒内定位“问题 - 方案 - 阻塞 - 结论”
  • 风格一致：读起来仍像原作者
  • 格式规范：目标文章满足 Markdown 常见排版规范，混排文本可读性稳定

禁止事项

• 禁止擅自新增业务结论或技术承诺
• 禁止删除“看似重复但实际承载约束条件”的描述
• 禁止统一替换作者语气为模板化公文风
• 禁止把关键术语改成同义词导致语义偏移
• 禁止套用固定章节模板覆盖原文真实逻辑顺序
• 禁止把原文压得更像 AI 总结稿：更整齐但更空
• 禁止无意义扩写、同义复述、过度收束

后续纠偏原则

• 若用户在后续对话中对文档中的事实进行纠偏，以用户最新说明为准。
• 纠偏时采用最小改动原则：只修正被纠偏的事实与其直接关联表述，不做额外风格重写。
• 若纠偏会影响上下文一致性（标题、结论、状态标签），需同步更新相关段落，避免前后矛盾。
• 若用户纠偏与原文存在冲突，不保留“历史正确性优先”，而是保留“当前作者意图优先”。