在前端验收文档中，频繁出现“同款”“同款样式”“同款布局”等表述，容易导致报告内容冗长、重点分散。很多团队存在一个常见误区：虽然追求一致性本身没有问题，但描述方式完全可以用更精准的语言来替代。推荐的做法是使用组件ID或规范编号来替换这些重复的模糊表述。具体而言，视觉一致性可改写为“符合UI规范#Color-02/Radius-04/Shadow-01”，交互逻辑一致则可表述为“遵循交互规范#ClickFeedback-03”，若文案尚未替换，直接标红原文并添加批注即可。

识别重复提示词的高频出现模式

打开最近3次验收文档，搜索“同款”这个关键词，就能快速定位其出现位置：顶部导航栏、卡片组件、按钮组、弹窗标题栏。统计数据显示，87%的“同款”实际指向设计稿中已标注的【全局组件规范V2.3】，而非临时比对的结果。这一步必不可少，否则后续替换时容易误删真正需要强调的差异点，影响前端验收的准确性。

用组件ID替代模糊的“同款”描述

具体有两种操作方式。第一种，在Figma设计稿中找到对应模块右上角的组件ID，例如Button/Primary/Large#042或Card/Feed/Compact#119，验收时直接写“调用Button/Primary/Large#042”即可。第二种，如果开发环境已接入Storybook，点击组件后复制permalink链接，粘贴到验收备注栏中，例如：https://sb.example.com/?path=/story/button--primary-large#042。

需要特别强调的是：务必确认该ID与当前开发分支匹配，切勿复制master分支上的ID用于feature/login页的验收。

建立三类验收关键词映射表

第一步，将验收中所有包含“同款”的句子归为三类——指向视觉一致性的（如颜色、圆角、阴影），改写为“符合UI规范#Color-02 / Radius-04 / Shadow-01”；指向交互逻辑一致的（如点击反馈、加载态、禁用态），改写为“遵循交互规范#ClickFeedback-03”；指向文案或占位符未替换的，直接标红原文并批注“需替换为业务文案，非复用占位符”。

第二步，将这三类改写结果存为飞书文档模板，每次验收前直接插入对应段落即可。这样既能保证验收术语统一，又能让验收报告更加清晰、聚焦，提升前端验收文档的专业度和可读性。