模板
intent 模板
做什么、为什么、约束、不做什么、成功指标
亲历产品组织阶段 · 通用更新于 2026-10-16
动手之前，先用不到一页纸写清楚五件事：做什么、为什么、约束、不做什么、成功指标。产品档的项目把它写成 spec 的第一节（docs/specs/YYYY-MM-DD_<slug>.md 开头的“Intent”）；线上问题回流到规划时，也可以先单独写一份，再扩成 spec。写完由你本人确认，这是规划阶段唯一的人工关卡。
为什么要先写 intent
Anthropic 的 AI-native SDLC playbook 把它列为第一招：一份很短、进版本控制的文件，说清要什么、为什么、在什么约束下，然后在一次会话里和 Claude 一起把它变成需求和设计规格；线上指标出了问题，也写成一份新的 intent，重新进入规划。
我的体会是：写代码早就不是瓶颈，慢的是“到底要做什么”。intent 逼你在 agent 动手之前把这件事想清楚，也给后面的 spec、审查、复盘一个可以对照的原点。
模板
## Intent
- 要做什么：（一句话，写结果，不写方案）
- 为什么：（谁、遇到什么问题、为什么是现在）
- 约束：（技术、合规、预算、时间，尽量写具体数字）
- 不做什么：（明确排除的范围）
- 成功指标：（上线后看哪个数、多久看、多少算成功）
- 待定问题：（还没想清楚、留给设计阶段回答的）
- 来源：（想法 / Issue 链接 / 告警链接）
- 确认：（谁、哪天）示例
## Intent
- 要做什么：让用户给待办加标签，并按标签筛选列表
- 为什么：待办超过 50 条以后，用户反馈很难找到想要的那条；按标签筛选是 Issue 里被提到最多的需求
- 约束：不引入新的付费服务；每条待办最多 10 个标签；两周内上线
- 不做什么：不做标签颜色自定义，不做跨用户共享标签，不做标签批量重命名
- 成功指标：上线 30 天内，周活跃用户里使用过标签筛选的比例达到 20%
- 待定问题：标签名要不要限制长度，留到设计阶段定
- 来源：Issue #42
- 确认：产品负责人，2026-10-16每一项怎么填
| 项 | 怎么填 | 最容易犯的错 |
|---|---|---|
| 要做什么 | 一句话，写用户能感知到的结果 | 写成方案，比如“加一张 tags 表和三个接口”，那是 spec 的事 |
| 为什么 | 谁、遇到了什么问题、为什么现在做 | 写“提升用户体验”这种没法证伪的话 |
| 约束 | 技术、合规、预算、时间，能写数字就写数字 | 只写“尽快”，agent 没法据此取舍 |
| 不做什么 | 列出容易被顺手做掉、但这次明确不做的事 | 留空。这一项最容易省略，也最有价值：agent 默认会“顺手”多做 |
| 成功指标 | 上线后看哪个数、多久看、多少算成功 | 写“用户喜欢”，或者写了数字却没人会去看 |
| 待定问题 | 还没想清楚、留给设计阶段回答的问题 | 不写，然后悄悄按自己的假设往下做 |
| 来源 | 想法、Issue、告警的链接 | 不写来源，三个月后没人记得这件事为什么开始 |
怎么写出来
自己对着空白模板硬想，往往会漏掉关键问题。我的做法是先用 /mattpocock-skills:grill-me 让 Claude 拷问：它按轮次提问，每题给出推荐答案，问到每个分支都有答案为止，再让它把结论整理成上面的格式。这本手册的需求就是这么定下来的：读者是谁、公开边界在哪、流程引擎选哪个，全部在拷问里拍板，然后才动手。
拿不准值不值得做的新方向，也可以先跑一次 gstack 的 /office-hours，它会追问这件事是否真的值得做。