为什么先写 Brief
如果只跟 AI 说“帮我做一个客户管理平台”,它会生成一个看起来什么都有、实际每一条都不完整的项目。不是 AI 不努力,是输入没有边界。
一页 Brief 只需要回答六个问题:
- 谁用?
- 在什么场景用?
- 输入是什么?
- 输出是什么?
- 什么情况下必须拒绝/提示?
- 第一版不做什么?
模板
项目名:
一句话目标:让【谁】在【什么场景】完成【什么动作】。
用户与场景:
- 主要用户:
- 使用频率/时机:
- 现在他们怎么完成这件事:
第一版范围:
- 入口:
- 主路径(最多 5 步):
- 输出/结果:
- 必须处理的异常:
- 明确不做:
数据与权限:
- 涉及哪些数据:
- 谁能看/改:
- 什么情况下必须拒绝:
验收:
- 一条主路径:
- 三个异常输入:
- 一个权限边界:
- 上线地址/演示方式:
不承诺/边界:
-
填写示例:客户资料页
项目名:客户资料页 v0.1
一句话目标:让工作室负责人在登录后按客户名查询合同和回款状态,且只能看到自己的客户。
用户与场景:
- 主要用户:工作室负责人
- 使用频率:每天
- 现在:在文件夹和聊天记录里翻合同
第一版范围:
- 入口:登录页
- 主路径:登录 → 输入客户名 → 查看合同/回款 → 退出
- 输出:客户名、合同编号、回款时间
- 必须处理的异常:查不到、未登录、无权限
- 明确不做:新增合同、导出、多人协作
数据与权限:
- 数据:客户、合同、回款
- 权限:只允许看当前登录账号名下的客户
- 拒绝:未登录、跨账号查询
验收:
- 主路径:A 登录能查到 A 的客户
- 异常:空输入/不存在的客户有提示
- 权限:B 登录查不到 A 的客户
- 演示:本地地址 + 一页操作记录
写完 Brief 之后
下载 Markdown 版模板
复制到项目里,填完再开工。
继续读
- Vibe Coding 是什么 — 先理解工作方式
- 零基础第一个网站 — 按 4 周路线推进
- 上线前检查清单 — 上线前逐项过