提供示例

一个具体的示例抵得上一段描述。如果你想要某种特定形状的输出，就把那个形状给它看。这是消除歧义最快的方法。

Format the data nicely.

Transform this array of users into a summary object.

Input:
  [{ name: "Ann", role: "admin" }, { name: "Bo", role: "user" }]

Desired output:
  { total: 2, byRole: { admin: ["Ann"], user: ["Bo"] } }

Write the transform function and a test matching this example.

示例钉死了命名、结构和大小写——这些光靠文字会留得模糊不清。当你能做到时，把示例作为一个测试包含进去——这样"让这个测试通过"就成了一条没有歧义的指令。这个套路可以推广：一份样例 API 响应钉死一个解析器，一对"改前/改后"钉死一次重构，一张截图或 ASCII 草图钉死一个布局。每当你发现自己正在写一长段对某个形状的描述时，停下来，改为给它看那个形状的一个实例。