把截图和口述反馈整理成明确的 UI 修改请求

每条口述的 UI 反馈，都应对应一个可见区域、一项修改要求和一个可以检查的结果。截图说明问题在哪里，编号清单则解释你希望界面怎样变化。

这样的任务比“做得更清爽一点”更方便 AI 编程工具理解。它也有助于保留页面里已经好用的部分，只调整妨碍操作流程的地方。

给图片加一张简明的区域地图

下图是为本指南原创的虚构任务界面。数字用于标识讨论区域；它不是 CueSpec 或任何已部署产品的截图。图中的界面文字保留英文。

在文字请求中使用相同的编号：

为自己的页面准备截图时，截取有用的区域，同时保留足够的周边内容，让人能确定位置。如果图片包含私人工作信息，分享前先替换或移除这些细节。编号只是讨论辅助，不是精确的像素坐标；在响应式布局中，同一个元素可能会移到其他位置。

复制这份反馈模板

页面与状态：
[当前打开的是哪个界面？用户刚刚做了什么？]

参考材料：
[附上相关图片，并标明区域编号。]

目标：
[对使用这个界面的人来说，什么应该变得更容易？]

1. 区域 [编号]：
   当前情况：[…]
   修改要求：[…]
   检查方式：[可观察的结果。]

2. 区域 [编号]：
   当前情况：[…]
   修改要求：[…]
   检查方式：[可观察的结果。]

保留：
[应保留的有用行为、内容或视觉特征。]

准确文案：
[把必须逐字使用的文字单独贴出，与一般风格要求分开。]

下一步范围：
[讨论方案／准备草稿／实施这些修改。]

目标和理由可以口述。必须准确出现的文字则用键盘输入，包括按钮标签、产品名称和技术标识。这样就不容易把“差不多叫 Open reply 之类的”误当成最终文案。

三份完整反馈示例

以下请求都对应上面的虚构示意图，分别展示布局、措辞和交互三种验收检查。它们不是已完成修改的报告。

1. 间距：让标题和第一项任务更容易区分

页面与状态：
项目任务视图，第一项任务可见。

目标：
让项目标题和任务列表呈现为不同层级。

区域 1：
增加标题区域与任务列表之间的视觉区隔。
项目名称仍与卡片左边缘对齐。

检查方式：
第一项任务看起来不再像标题的一部分。
在较窄宽度下，项目名称可以换行，且不与列表重叠。

保留：
项目名称、任务顺序和现有导航。

下一步：
使用现有字体样式，展示一份布局提案。

这份请求描述的是层级关系，没有随意指定某个间距数值。如果设计系统已有适用的间距变量，补上它的准确名称。否则，可以让实施者提出一个数值，再检查布局结果。

2. 文案：让操作标签与实际结果一致

页面与状态：
任务卡片显示已返回的回答，等待读者查看。

区域 2：
保留任务标题和回答预览。

区域 3：
虚构的当前版本把这个操作标为“Reply”。
它会打开回复编辑器，不会发送消息。
把标签改为示意图中的“Open reply”。

准确文案：
Open reply

检查方式：
可见标签是“Open reply”。
控件仍然只打开回复编辑器，不发送任何内容。
它的无障碍名称也表达同一个操作。

保留：
当前跳转目标和草稿内容。

下一步：
准备这项措辞修改，不重新设计视觉样式。

关键在于区分“打开编辑器”和“发送消息”。Open reply 在这里表示打开回复编辑器。更短或更有行动感的标签，只有准确描述实际操作才有用。

3. 交互：切换视图后保留回复草稿

页面与状态：
任务卡片已打开，回复编辑器中有一份尚未发送的草稿。

区域 2 和 3：
返回任务列表后，再次打开同一个任务时，
让这份草稿仍然关联到该任务。

检查方式：
在回复编辑器中输入英文示例草稿“Keep the current heading.”。
返回任务列表，再次打开同一个任务。
草稿仍然存在，并且没有发送任何消息。
打开另一个任务，确认这份草稿没有出现在另一个任务的回复中。

保留：
单独、需要明确操作的发送动作。

下一步：
先说明需要的状态行为和可选的实现方案。

这是针对虚构界面提出的交互要求。请求给实施者提供了之后检查行为的方法，没有暗示这个功能已经存在。

把参考材料和指令分开

截图可能是当前布局的证据、灵感参考，也可能是一份设计提案。请说明它属于哪一种。“参考这里的信息分组方式”比“匹配这些尺寸”留出了更多设计空间。

口述时，也应把容易混在一起的三件事分开：

• 含义： 用户应该理解什么，或完成什么。
• 准确内容： 必须出现的文字和标识。
• 呈现方式： 支持这项任务的层级、间距和交互。

如果反馈涉及多个界面，每个界面各用一张编号地图。只有在相同行为确实应该跨界面适用时，才提出一条共享规则。

用同一张区域地图检查结果

回到每个编号项，逐一检查约定的结果。新布局即使看起来精致，也可能漏掉要求的行为；交互即使正确，在较窄宽度下仍可能出现文字难以阅读的问题。把图片、清单和检查方式放在一起，让下一轮复核仍然围绕同一项任务。

如果你通过 CueSpec 附上图片，其 Docs 介绍了添加回复附件和检查粘贴的截图。无论最终由哪个编辑器或编程工具接收请求，都可以使用上面的模板。