用途
paper-ds-review 用于对照真实的产品语境,验证某一个真实的 Paper 设计稿或修订版本,检查其系统、状态、宽度、主题等方面。它不发明替代方案,而是基于已有节点、源码和修订进行核查。
主要能力
- 加载 paper-ds-canvas 以及 ../paper-ds-manage/references/versioning.md,读取精确选定的节点、源码和修订,而非仅看组件名称。已有的用户编辑也属于被检查对象的一部分。
- 读取 ../paper-ds-options/references/comparisons.md,只选择可能改变结论的检查项。修订会使用实际的 Current 和 Proposed。单个组件可能需要长内容、相关状态、主题、宽度或其所在屏幕。除非被要求,否则不生成替代方案。
- 阅读源码和当前设计稿。如果所选节点不可用,则询问而不是绘制替代品。如果源码与 Paper 不一致,需确认正在评审的是哪个设计。
- 将此前未记录的稿件或用户编辑捕获为基线或草稿检查点。评审未变更的修订不会分配新的稿件修订。
- 仅在需要单独评审展示时克隆 Sheet Review,否则复用现有的足够展示。包含 Focus、相关 States 和 In context;移除空部分和不支持的主题。
- 使用真实内容和实际周边组件。不把 320px 截图当作响应式 200px 渲染展示,而是在真实宽度下重排。
- 检查缩放值、语义角色、对比度、内容压力、实际状态、可选槽位以及被检查对象与相邻元素的契合度。对于行为或实现层面的断言,需在真实产品中运行适用的检查。静态 Paper 截图无法证明键盘行为或加载逻辑。
- 在对象的 reviews 中记录所检查的修订和 token 快照、验证证据以及未解决的问题。仅对在当前 token 和源码下完成的检查清除 needsReview;未完成的验证应保持为 true。
- 以简洁发现回复,每条指出位置、问题和修复方式,并说明未测试的内容。干净的评审是证据,不代表用户批准或已发布修订。
评论处理
Sheet 只承载设计。不绘制评论卡片、发现行、图钉或评审备注。发现内容应放在对话中。
在可用时读取现有原生 Paper 评论作为输入。未经明确许可,绝不创建、修改或解决某条讨论线程。公开示例中不得包含私有文件 URL 和评审产物。
后续步骤
请求的修复使用 paper-ds-iterate,获得明确批准的修订使用 paper-ds-land。不要在评审过程中自动更改代码或规范稿件。
限制
该技能本身不生成替代方案,不自动修改代码或规范稿件,也不能通过静态截图验证键盘行为或加载逻辑。部分使用方式、平台或收费等信息,原始资料暂未提供。