用途:对设计做“合理性(soundness)”评审,回答“这东西到底该不该做、这是否是从既定目标与约束推导出的设计”。它明确区分三类评审:完整性(各章节是否填满)、正确性(单个论断是否属实)与合理性(本技能职责)。
主要能力:先读取并端到端通读待评文稿,再追溯其继承的上游决策(父提案、相关 ADR、同一子系统的复盘、supersedes 链)。随后用自身话复述该设计的论证并回示用户;若无法复述目标、约束及推导关系,则此即发现,应退回让作者先把论证写清楚。
评审视角:问题(是否在解决真问题而非症状)、目标推导(设计是否由目标推导还是事后合理化)、备选方案(是否针对稻草人)、约束(硬约束与继承习惯之别)、成本(长期维护负担)、可逆性(单向门还是双向门)、失败(承重假设的边界与既往复盘)、简洁(是否有更小的等效设计)、范围(非目标是否夹带关键范围)。
发现格式:每条含主张、证据(须引用原文或链接,无证据即删除)、严重度(blocking / substantive / minor)与处理建议;按严重度而非阅读顺序排序。交付后须自我校准:以作者视角尝试推翻每条发现,标注置信度与反证条件,合并重复项;若校准后无 blocking 与 substantive,应如实说明。
使用方式:默认以对话消息交付;仅当用户要求或评审足够重要时落盘为文档,写在被评文稿旁,并在其未决问题处加相对 markdown 链接,声明其为建议性输入。
限制:它不产出修改,除非明确要求绝不重写被评文稿;不做完整性清单、不事实核查、不做代码评审;不是最终裁决,作者拥有决定权;承载修复的发现应路由回相应技能(如 /frame-a-proposal、/write-a-spec、/record-a-decision)。