By name: doc-style
description: >
结构化编写、重构、润色和验收 Markdown / MDC 文档。
只要用户要创建、编辑、润色、改写、评审或整理任何 .md / .mdc 文件，
或需要整理规则文档、普通说明文档、PR review 评论、GitHub 评论、零散草稿，就应使用这个 skill。
Doc Style
0x01 定位
doc-style 负责 Markdown / MDC 文档的结构设计、表达压缩与交付前润色。
适用范围：
- 文件范围：所有
.md/.mdc文档编辑、重构、润色与验收。 - 其他文档类型：规则文档、普通说明文档。
- 短交付：PR review 评论、GitHub 评论、零散草稿的结构化压缩。
职责边界：
- 只处理文档内容、结构和表达。
- 不负责外部资产定位、元数据治理或发布流程。
0x02 通用必读
【CRITICAL（必须执行，不可协商）】无论文档类型是什么，都必须先读 references/common/ 下全部 5 个文件：
0x03 写作流程
- 判定目标：明确文档目标读者、交付形态和读者需要拿到的结论。
- 读取规范：先读
common/全部5个文件。 - 完成初稿：按规范写作。
- 润色与自检：见
0x04。
0x04 润色与自检
完成初稿后执行润色闭环：
- 规范回扫：用
common/规则逐节核对，违例就地修复。 - 闭卷通读：从目标读者视角通读初稿，确认读者不需要追问「结构长什么样」「字段在哪一层」「下一步做什么」。
- 长句拆分回看：拆长句后回到
paragraph.md的载体选择规则，确认不是源码硬换行或连续孤立短段。 - 主观清单：按下表列出
5张主观审稿清单。
【CRITICAL（必须执行，不可协商）】审稿自检不能用自动检查替代。
清单执行约束：
- 只列举问题点，不直接改文档：由作者评估后再决定是否采纳。
- 每条问题点给出原文位置（小节号或原句片段）和建议替换 / 改写方向。
- 无问题时写"无"：不省略清单。
| 清单 | 定义 | 判定要点 |
|---|---|---|
| 黑话清单 | 仅在特定圈层成立、脱离圈层即丢失语义的词语 | 圈外读者无法独立读懂，依赖默会知识、内部缩写、外文夹杂或隐喻 |
| 晦涩清单 | 读完仍需回看才能理解的语句 | 术语堆叠、被动嵌套、省略主语、长定语前置 |
| 冗余清单 | 对结论无新增信息量的内容 | 过程叙述、跨节重述、为衔接而衔接的句子 |
| AI 味清单 | 模板化、与具体上下文脱钩也照样成立的表达 | 句子换主题仍然读得通，或堆积空泛形容词与机械承接转折 |
| 审美缺点清单 | 以「极高文档审美的专业领域评审专家」视角列出的缺点 | 结构、行文、叙事节奏、信息层级、留白与对齐 |
- 是否执行了润色与主观清单自检。