Plate 项目中的规划文档一致性评审coherence-reviewer 技能的设计与实践【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate导读本文讲解 PlateGitHub_Trending/pl/plate基于 shadcn/ui 的富文本编辑器仓库中.agentsAgent 技能体系里的coherence-reviewer技能它专门用于审查规划类文档RFC、方案、需求清单的内部一致性捕获文档与自己打架的问题——章节矛盾、术语漂移、结构缺陷、歧义和失效引用。读完本文你将掌握这套评审方法论的核心判定规则、置信度分级标准以及不该报什么的边界约定并了解它在 Plate 的major-task文档评审通道中的实际接入位置与用法。一、技能定位coherence-reviewer 是什么coherence-reviewer是 Plate 仓库.agents/skills/目录下的一组文档评审document-review类技能之一定义文件位于 .agents/skills/coherence-reviewer/SKILL.md。从技能元数据看namecoherence-reviewerdescription审查规划文档的内部一致性——章节间的矛盾、术语漂移、结构问题以及会让读者产生分歧的歧义由 document-review 技能派生spawned by the document-review skill。modelhaiku低成本模型即可胜任说明该评审任务的推理门槛较低、规则明确。来源metadata 中标明其原型为plugins/compound-engineering/agents/document-review/coherence-reviewer.md即来自 Compound Engineering 插件体系的文档评审代理。在 skiller-lock.json 中可以看到该技能由 Plate 从EveryInc/compound-engineering-plugin安装并锁定这印证了它是外部插件经裁剪后纳入本仓库 Agent 技能体系的一部分而非临时脚本。角色边界是本技能最核心的设定它不评估方案好不好、可不可行、完不完整——那是其他评审者feasibility-reviewer、scope-guardian-reviewer、product-lens-reviewer 等的职责它只抓文档是否与自己矛盾。换句话说coherence-reviewer 是一个纯粹的内部一致性守门员。二、评审目标六类要猎捕的问题SKILL.md 用 What youre hunting for 明确列出了评审者要主动搜索的六类问题这是本文档的骨架逐条展开如下。1. 章节间的矛盾Contradictions between sections当文档的两个部分无法同时为真时就是一条 finding。典型的触发模式范围scope声明 X 不在范围内但需求清单里却包含了 X概述说无状态stateless后面某个章节却描述了服务端状态前面章节设定的约束被后面提出的方案违反。判断标准是两部分能否同时成立而不是措辞是否完全一致。2. 术语漂移Terminology drift同一概念在不同章节被叫成不同名字例如同一个东西一会儿叫 pipeline、一会儿叫 workflow、一会儿叫 process或者同一个词在不同位置指代不同事物。判定标准是读者是否可能被搞混而不是作者是否每个词都用了同样的写法。3. 结构问题Structural issues前向引用forward references指向从未定义过的东西某些章节依赖上下文但该上下文从未被建立分阶段方案中后面的阶段依赖前面阶段从未提到的交付物。此外还有一个明确要求当需求清单跨越多个互不相关的关注点如打包、迁移、贡献者工作流时扁平列表会妨碍人类与 Agent 的理解。此时应以autofix_class: auto标记并按逻辑主题分组同时保留原始 R# ID便于追踪。4. 真正的歧义Genuine ambiguity指两个细心的读者会对同一句话做出不同解释的情况。常见来源没有边界的量词quantifiers without bounds没有穷尽分支的条件逻辑可能是穷举、也可能只是示例的列表隐藏责任人的被动语态passive voice hiding responsibility时间歧义——例如迁移之后after the migration到底指迁移开始、完成还是验证通过之后。5. 失效的内部引用Broken internal references如第 X 节所述但第 X 节并不存在或者声称的内容与实际不符。6. 未解决的依赖矛盾Unresolved dependency contradictions当文档明确提到需要某个依赖dependency却没有给出任何解决方案没有 owner、没有时间线、没有缓解措施时就构成我们需要 X与没有任何交付 X 的计划之间的矛盾。三、置信度校准什么值得报、报多高SKILL.md 给出了明确的置信度confidence分级规则用于控制噪音级别区间判定依据HIGH0.80可从文本直接证明——能引用两段互相矛盾的原文MODERATE0.60–0.79很可能不一致善意解读可调和但实现者大概率会走向分歧抑制 0.50完全不报这套分级保证了评审产出可被下游自动过滤高置信度条目作为硬问题提交中等置信度作为待确认项低置信度则直接抑制避免评审报告淹没在猜测里。四、不报清单评审者的自我约束为避免越界这是文档评审体系中职责分工的关键部分SKILL.md 明确列出以下内容不在coherence-reviewer 的职责内风格偏好措辞、格式、项目符号 vs 编号列表属于其他角色职责的缺失内容如安全漏洞、可行性问题不构成歧义的不精确表述fast 是含糊的但不是不连贯的格式不一致标题层级、缩进、Markdown 风格结构能自洽时的文档组织意见例外跨多个关注点且未分组的扁平需求列表——这属于结构问题而非风格偏好明确延期的内容TBDout of scopePhase 2受众无需正式定义就能理解的术语。这份不报清单与 Plate 文档评审体系中的分工呼应。例如 .agents/skills/adversarial-document-reviewer/SKILL.md 在其 What you dont flag 一节中明确写着内部矛盾或术语漂移归 coherence-reviewer 所有Internal contradictions or terminology drift — coherence-reviewer owns these可行性问题归 feasibility-reviewer范围目标对齐归 scope-guardian-reviewer产品框架归 product-lens-reviewer。多份技能文档互相引用、互不重叠本身就是这套评审体系内部一致性的体现。五、在 Plate 中的接入位置与使用方式coherence-reviewer 并非随时待命而是作为major-task 通道的文档评审通道document-review pass条件性接入。证据见 docs/analysis/compound-engineering-tree.md└── major-task conditional document-review pass ├── coherence-reviewer ├── feasibility-reviewer ├── scope-guardian-reviewer ├── product-lens-reviewer └── adversarial-document-reviewer同一文档docs/analysis/compound-engineering-tree.md 第 147–161 行还给出了选择规则coherence-reviewerfeasibility-reviewer评审明确方案plan、RFC、提案或规格时的默认组合scope-guardian-reviewer当抽象数量、发布形态或范围漂移气味过浓时追加product-lens-reviewer文档包含产品定位、价值、路线图类论断时追加adversarial-document-reviewer文档体量大、假设密集、架构密集或风险高时追加。关键约束是选择是克制的major-task不会因为存在文档就加载全部评审者The rule is selective. major-task does not load every reviewer just because a doc exists。这解释了为什么仓库中的规划文档docs/plans/是由多条评审通道分层把关的而不是一次性全量轰炸。在 docs/plans/2026-05-16-slate-v2-unified-extension-composition-ralplan.md 中可以看到实际使用记录coherence-reviewer | applied in pass 10用途是合并 pass 7/8/9 的细化结果确保目标代码片段、规则表、验证门槛和未决问题之间不发生冲突——这正是本文档所述的章节间矛盾与术语漂移两类问题的实战应用。六、使用前提与局限适用对象本文描述的是 Plate 仓库内 Agent 技能体系的设计适用于阅读和复用该技能进行规划文档评审。技能本身是纯方法论prompt 型技能不依赖运行时可直接在其定义文件 .agents/skills/coherence-reviewer/SKILL.md 中查看完整原文。评审边界它只处理文档与自身的一致性不替代可行性、范围、产品视角等评审在接入其他评审者如 adversarial-document-reviewer时需要依赖各技能自带的不报清单完成职责划分。置信度阈值0.50 以下的推测被抑制这意味着它产出的是可引用原文证明或很可能但待确认两类结论不会输出低价值猜测。七、小结coherence-reviewer 用一份不足 40 行的技能定义把内部一致性评审这一看似主观的工作拆解成可执行、可分级、可约束边界的评审协议六类猎捕目标、三档置信度、一份不报清单。在 Plate 的major-task文档评审通道中它与 feasibility-reviewer 组成默认评审对并与其他评审者通过交叉引用实现职责互斥。对任何使用 Agent 技能体系维护大型规划文档的团队而言这套一致性守门的判定框架都具备直接的可移植价值。延伸阅读仓库内路径.agents/skills/coherence-reviewer/SKILL.md——本文所述技能的完整定义原文.agents/skills/adversarial-document-reviewer/SKILL.md——评审职责分工的交叉引用示例.agents/skills/feasibility-reviewer/SKILL.md——默认评审对中的可行性评审者docs/analysis/compound-engineering-tree.md——Plate 对 Compound Engineering 技能树的裁剪与接入说明docs/plans/2026-05-16-slate-v2-unified-extension-composition-ralplan.md——coherence-reviewer 的实战应用记录pass 10skiller-lock.json——技能来源与安装锁定信息【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考