doc-organization
Installation
SKILL.md
文档信息组织
管信息落在文档的哪个位置,不管表达文笔。
这里只有五条原则,没有判据、没有阈值、没有严重级。审阅文档时按这五条判断,并明确说明这是判断而非检测——内容组织的问题无法机械判定。
本 skill 只判断与说明,不执行修改。 若据此改文档,改动限于三类:搬位置、补定义、删重复副本;任何需要重写句子才能达成的"改进"都不属于本文范围。
Language
- 接受中英文提问,统一中文回复,文档用中文
1. 正文只写当前状态,变更历史另置
危害不是难读,是当前状态失去确定性。
历史与当前混在同一处时,读者无法判断哪一句是活的。一份文档的引言里放两条修订记录、而正文还留着被它们推翻的旧说法,等于对"当前设计是什么"给出了两个答案。