把相互冲突的口述反馈整理成一份 Agent 任务说明

在有人作出相关决定之前，分别保留每位参与者的观察、解释和建议动作。之后，再根据已定选择与约束编写开发任务说明，并继续保留每项选择的来源。

这是一种手动整理已有笔记的方法。它适用于书面反馈，也适用于谈话后整理的笔记；不要求会议录音工具、说话人识别或自动决策工具。

保留三个清楚可见的来源

设想一个虚构的项目页面。在它的窄屏设计稿中，项目名称折成两行，工具栏里有一个 Export 按钮。本例现有的导出契约是包含 project_id,title,status 三列的 CSV；文件命名规则与下载路由应保持不变。

下面三则短笔记、角色标签及后续决定都是虚构的教学材料，不是客户引语、访谈、录音或产品测试观察。

N1 — 设计评审者：“在这张窄屏设计稿中，项目名称折成了两行。我觉得工具栏太挤。把 Export 移到 More 菜单里，而且只使用一个箭头图标，不带文字。”

N2 — 支持评审者：“标签只写 Export，我分不清导出的是 CSV 还是 PDF。在工具栏保留一个可见的 Export CSV 按钮。”

N3 — 发布负责人 R1：“保留当前 CSV 列、文件命名规则和下载路由。我们可以先把文字写清楚。我还没有在工具栏与 More 菜单之间作出选择。”

这些笔记有共同关注点：三者都涉及导出操作。本例中也确实存在分歧：仅图标还是可见文字，以及工具栏还是菜单。不能因为把笔记统称为“改进导出”，就抹去这些差异。

把实际看到的与推断的分开

GOV.UK 服务手册的分析方法区分观察、解释得出的发现以及行动决定。下表把这个区分用于开发任务说明；这并不会把虚构笔记变成用户研究。

来源	观察或明确约束	解释	建议动作	需要决定什么	负责人/状态
N1	设计稿中的项目名称折成两行	工具栏可能太挤	把导出移到 More	是否改变位置	R1；待定
N1	没有单独的观察证明图标更清楚	图标可能减轻视觉分量	使用不带文字的箭头图标	仅图标还是可见文字	R1；需要选择
N2	当前可见标签是 Export	这位评审者不清楚文件类型	使用 Export CSV	本轮的确切标签	R1；需要选择
N2	没有提供位置对照测试	保持操作可见可能有帮助	保留工具栏位置	工具栏还是 More	R1；待定
N3	保留列、文件命名规则和下载路由	现有导出行为不在所请求改动的范围内	先改文字	使用什么文字	R1；已有明确约束，仍待选择

一种解释即使尚未证实，也可能有参考价值。虚构设计稿中确实能看到名称折行；但移动 Export 就能解决问题的说法，仍需要设计决策与后续检查。

不要把同一参与者的两则笔记算成两张独立选票。来源标签说明陈述来自哪里，不代表其统计权重。

记录选择，不编造共识

在这个完整案例中，R1 接着给出以下决策记录：

决策	第一次改动已定的内容	依据
D1	使用可见标签 Export CSV	R1 选择 N2 的措辞；本轮不采用仅图标方案
D2	本轮保留当前工具栏位置	R1 限定首次交付范围；更广泛的位置决策仍待定
D3	保留 CSV 列、文件命名规则和下载路由	N3 中 R1 提出的约束
D4	本次交付不做其他布局或导出行为改动	R1 先改文字的范围限定

尚未解决的位置问题单独保留记录：

待定决策 O1
问题：今后是否应把导出从工具栏移到 More？
来源：N1 建议移动；N2 倾向保持可见。
决策负责人：发布负责人 R1。
状态：尚未决定未来的布局改动。
仍需的证据：比较实际布局选项及其可用性。
当前交付：保留现有位置；不实施任何一种未来重设计。

为了小范围补丁保留当前位置，是一项已定的范围约束。它不代表所有人都同意工具栏是最好的永久设计。

把摘要变成工作前，先检查摘要

一种误导性的摘要是：

“团队同意把图标移进 More，以简化导出。”

这句话选择了 N1 的建议，遗漏了 N2 对可见标签的偏好，还声称笔记中存在从未达成的共识。

可以追溯来源的摘要是：

“R1 选择 Export CSV 作为第一次改动的可见标签。现有工具栏位置与导出行为保持不变。未来使用工具栏还是菜单的问题仍待定，并保留 N1 与 N2 的提案。”

摘要可以比矩阵短，因为矩阵仍然保留着。如果有人质疑其中一句话，可以回到原笔记或决策，而不必让润色过的段落自己证明自己。

复制完整的实施任务说明

GitHub 的限定任务范围指南把问题、验收条件与相关文件指引视为有用输入。下面是虚构案例中已经定下的部分，可以按真实项目调整：

任务：写清现有导出操作的标签。

当前状态：
项目工具栏中有一个标签为 Export 的操作。

要求的改动：
使用可见标签 Export CSV。
确保操作的无障碍名称标识同一个导出操作。
找到现有控件，并返回实际检查/修改的确切文件。

保留：
- 当前工具栏位置及周边布局。
- CSV 列 project_id,title,status，顺序不变。
- 现有文件命名规则、下载路由和导出行为。

范围：
只改标签及其直接对应的无障碍命名。
不要移动控件、把它替换成仅图标操作，
也不要重新设计工具栏或导出流程。

检查：
检查可见标签与无障碍名称。
检查控件是否保留现有位置和动作绑定。
使用项目的常规检查，对照导出契约与相关行为；
已经执行的检查与未运行的检查分别记录。

返回：
有针对性的改动、实际检查记录，
以及任何导致既定范围无法满足的实现细节。

决策引用：
R1 的 D1–D4 决策。保留原始 N1–N3 笔记作为上下文。

这份任务说明没有要求探索两种位置，也没有要求编造折中方案。那些内容都在已定范围之外。待定决策记录可以为后续工作提供信息，而不必变成埋在同一请求中的另一项动作。

在下一轮反馈中复用这套方法

来源 ID 与参与者角色：
原始笔记/引用：
观察或明确约束：
解释：
建议动作：
与另一个来源的冲突：
决策负责人：
实际决定，或仍待定：
哪些内容可以进入当前实施任务说明：

提案冲突时，使用负责人的明确决定。如果还没有选择，就提出需要决定的问题，让实施任务说明停留在已经定下的约束上。流畅的摘要能帮助阅读；共识来自决策过程，不会因为措辞变得顺滑就自动形成。