| 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 润色与自检
a. 润色
- 读取规范:完整阅读
0x02 提及的全部文档和 Humanizer,作为润色规范
- 细读文本:仔细阅读待润色文本,标出不符合润色规范的实例
- 重写违例:就地重写问题片段,保留原意和目标读者需要的上下文
- 呈现版本:交付人性化版本,不只列问题清单
修订后的文本必须满足:
- 大声朗读时听起来自然
- 自然地改变句子结构
- 使用具体细节而不是模糊的主张
- 为上下文保持适当的语气
- 适当时使用简单的结构(是/有)
b. 输出闸门
【CRITICAL(必须执行,不可协商)】审稿自检不能用自动检查替代,低于 90 分时,回到 0x04.a 重新润色。
| 维度 | 评估标准 | 得分 |
|---|
| 直接性 | 直接陈述事实还是绕圈宣告?(8 分:直截了当,1 分:充满铺垫) | /8 |
| 节奏 | 句子长度是否变化?(8 分:长短交错,1 分:机械重复) | /8 |
| 信任度 | 是否尊重读者智慧?(8 分:简洁明了,1 分:过度解释) | /8 |
| 真实性 | 听起来像真人说话吗?(8 分:自然流畅,1 分:机械生硬) | /8 |
| 精炼度 | 还有可删减的内容吗?(8 分:无冗余,1 分:大量废话) | /8 |
| 黑话清单 | 仅在特定圈层成立、脱离圈层即丢失语义的词语。圈外读者无法独立读懂,依赖默会知识、内部缩写、外文夹杂或隐喻 | /8 |
| 晦涩清单 | 读完仍需回看才能理解的语句。常见问题包括术语堆叠、被动嵌套、省略主语、长定语前置 | /8 |
| 冗余清单 | 对结论无新增信息量的内容。常见问题包括过程叙述、跨节重述、为衔接而衔接的句子 | /8 |
| 审美缺点清单 | 以「极高文档审美的专业领域评审专家」视角检查结构、行文、叙事节奏、信息层级、留白与对齐 | /8 |
| common 规范 | 按 0x02 的 5 个 common 文件检查。不满足一点扣 2 分,扣分上限为 28 分 | /28 |