Doc Style

0x03 写作工作流

1. 先判定文档类型、目标读者和交付物职责。
2. 读取 common-writing.md 与对象特化 reference。
3. 知识对象场景先确认 knowledge_mgr 的对象规则。
4. 先写主干结论，再补充支撑信息，让读者只读主干也能获得当前有效结论。
5. 将并列信息改写为列表或表格，不把多层逻辑塞进一个段落。
6. 当内容是“对象 -> 处理动作 / 必读文档 / 规则入口 / 文件归属”的映射关系时，必须优先表格化。
7. 若输入是零散草稿，先归并重复信息，再重写标题层级和段落结构。
8. 若文档承担评审职责，默认补齐验收、风险、验证或下一步动作。

0x04 Polish Gate

完成初稿后，必须执行一次固定润色闭环：

1. 回读本次使用过的 reference。
2. PLAN.md 场景额外回读 exemplars.md 中的评测基线，校准结构密度与表格化承载方式。
3. 逐段压缩句子，只保留可判定、可复用、可验证的信息。
4. 检查章节职责是否混淆，例如不要把需求主干写进 PLAN.md，也不要把调研细节写进 README.md。
5. 将可结构化的信息尽量收进列表或表格，并消除口语化、自述式表达。

0x05 交付前检查

• 默认执行以下命令。
• 若命令失败，先修正文档再重新执行，直到通过。

pre-commit run --files <doc-path-1> <doc-path-2> ...

交付时给出简短说明：

• 文档类型与本次读取的 reference。
• 是否执行了 polish gate。
• pre-commit 是否通过。
• 若未跑通，明确说明阻塞原因。