# 对齐与原型

分清事实、取舍与体验，把猜测变成可确认行为。

## 「做得更好用」还不是可实现的行为

用户说搜索结果不好用。你可能想到高亮、筛选、排序或布局，但这些选择解决的不是同一个问题。直接实现，会让猜测变成代码、测试和后续返工。

先把模糊处摊开：谁在什么场景下找什么？现在卡在哪里？什么变化能说明问题缓解？问清目标之后，才知道值得比较哪些方案。

## 先复述，再分清谁能回答

用几句话复述目标、使用者与成功条件，让对方有机会纠正。现有搜索接口返回哪些字段、仓库已有哪种组件，应该自己查代码和资料，不把调查工作变成用户问卷。

> Restate my intent before continuing
>
> — Matt Pocock, [source](https://x.com/mattpocockuk/status/2105628270930845990), 2026-10-01
>
> 本站译意：继续之前，先复述我的意图。

## 每轮只决定当前能决定的事

如果先决定是否保留旧排序，才能讨论默认排序，就先问前一个问题。每题给一个推荐项和理由，也说明另一选项适合什么情况。不要一次抛出一长串互相依赖的问题。

很小且清楚的改动可以跳过这轮对齐。需要用户选择的，是会改变行为或范围的取舍；已能查明的事实应先查实。

## 用原型回答手感问题

卡片够不够紧凑、筛选是否挡住结果，往往要操作后才知道。做两个廉价原型，让人比较同一个任务，而非只选喜欢的颜色。

记录选择了什么、为什么选，以及哪些还没确定。agent 自己偏好某个方案，不等于人已认可；原型也只是探索材料，不代表可直接交付。

Figure: 把模糊请求收敛成行为 ([d05-alignment-flow](/diagrams/d05-alignment-flow.zh.svg))

## 练习：拆开搜索结果页的三类问题

先把下面的问题各归一类，再写出回答者。试着解释为什么「要不要分两页」可能必须看过原型，才能给出可靠答案。

Figure: 查证、取舍与原型的区别 ([s05-three-questions](/art/s05-three-questions.zh.svg))

<!-- compare -->
| 问题类型 | 本站示例 | 谁来回答 |
|---|---|---|
| 事实 | 接口是否返回标签？ | agent 查接口与代码 |
| 取舍 | 默认按相关性还是时间？ | 用户决定，附推荐理由 |
| 体验 | 筛选与结果同屏是否拥挤？ | 人操作原型后选择 |

### 把模糊搜索需求变成可确认行为

- 任务：为上面三类问题各写下一步，不提前宣布方案获认可。
- 产出：一句目标、一个待决定取舍、一项原型比较任务。
- 验收：写出选定筛选后结果怎样变化，以及尚未解决的问题。

参考思路: 先查标签字段；向用户推荐默认相关性并说明理由；比较侧栏与折叠筛选。人确认后，记录筛选条件如何显示、如何清除和结果如何更新。

> **本站推论**
> 本站建议：原型比较时让两版执行相同的搜索任务，把观察和偏好分别记录。这有助于解释选择，但不构成普遍可用性结论。

## 怎样才算完成？

另一位协作者能从记录中区分已确认行为、事实依据和未决事项；人做出的取舍有理由。若还有问题会改变核心行为，就不要把它写成已定需求。

把已确认结果交给[规格与工单](/zh/specs-and-tickets)，让下一次会话能接着做。

## 速查

- **事实自己查** 先读代码和资料。
- **取舍分轮问** 推荐项带理由，等待人决定。
- **体验看原型** 记录选择与原因，再写入规格。

## 来源

- [Matt Pocock · 2026-10-01](https://x.com/mattpocockuk/status/2105628270930845990)
- [公开讨论 / Public discussion](https://www.aihero.dev/things-people-get-wrong-with-grill-me-and-grill-with-docs)

非官方、非商业的学习整理，与 Matt Pocock 无隶属或背书关系。所引作品版权归原作者；MIT 复用内容另附版权与许可声明。

本页说明图内嵌的 CSS 片段改编自 Archify（https://github.com/tt-a1i/archify），MIT 许可，完整许可如下。

### 完整许可：Archify (tt-a1i/archify)

```text
MIT License

Copyright (c) 2026 tt-a1i (Archify)
Copyright (c) 2025 Cocoon AI

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```