用途:在开发仓库中编写、重构或评审 Markdown/MDX 时使用,尤适用于 README、AGENTS.md 及内容密集、感觉晦涩的文档页面。目标是在不删除必要事实、不抹平作者语气、不把统一风格强加于所有仓库的前提下,让文档更容易使用。
主要能力:按五个缩放层级(句子、列表项、小节、页面、跨页面)做最小有效改动。句子层保留必要条件;列表层让各项结构平行、便于扫读;小节层让标题与开头确立该节职责;页面层服务于单一主要读者任务;跨页面层为易变事实安排明确的维护归属。
使用方式:先读取仓库写作规则、目标文档及周边页面以建立本地惯例;判断用户只要发现还是需要编辑(评审请求不授权改文件);用一句话说明页面的主要读者任务,找出阻碍它的少数结构,再施加最小修改;最后重读全页并检查差异。
限制:风格评审无法判定技术主张是否真实;删除“可选”“可能”“当……时”可能把有效条件行为变成错误保证;移动内容可能破坏自包含操作手册、复制的片段、搜索可发现性和离线使用;不同渲染器对 Markdown 组件支持不同,引入语法前须查看目标惯例;行数预算只是诊断信号。仓库另有 zoom-rules.md、anti-patterns.md、checklist.md 参考文件。部分细节暂未提供。