交给外包开发公司之前必须补全的4项——拿不到报价的真正原因
需求交出去了，报价却迟迟不来或事后增加，原因在于文档里没有写出各种情况。为每个界面补全状态、条件、结果、失败这四项，就能成为开发者无需反问即可判断的文档。
策划书发出去了，报价却迟迟不来。即使来了，也会附上一句“需要确认的地方很多”。
好不容易签了合同，接下来又会出现别的问题。看到做出来的界面，发现和自己设想的不一样。要求修改时，得到的回答是“这不是最初约定的内容”。
双方都没有做错什么。只是文档里没有可以用来判断的依据。
开发者会问这些问题
拿到需求文档的人会反问的问题，大体上是固定的。外包开发公司在报价前问的，也几乎一样。
- “这个界面什么时候出现？”
- “对接正在进行时，用户停留在哪里？”
- “如果被拒绝，界面会怎样？”
- “这是数字还是日期？可以直接输入吗？”
- “这些数据从哪里来？一个API够吗？”
- “点击这个按钮后，会新增什么，跳转到哪里？”
- “登录失败的话呢？”
- “结束日期早于开始日期时会怎样？”
并不是因为这些问题刁钻。而是没有这些答案，就写不了代码。所以也给不出报价。要报价，就得数清楚要做的东西有多少、情况有多少种，而这些情况文档里没有写。
文档里缺的，通常是同样的4项
界面画好了，功能也写了。缺的总是这四项。
1. 状态 — 这个界面现在处于什么状态
同一个界面，状态不同，看起来也不同：为空时、加载中、加载完成、失败时。通常只画了加载完成这一种状态。
- 这样写不够 — 显示已关联的账户列表
- 应该这样写 — 关联前 / 关联中 / 关联完成 / 关联失败 — 四个界面
2. 条件 — 什么时候出现
如果没有写明按钮或提示文字是始终显示，还是只在特定条件下显示，开发者要么来问，要么自行决定。
- 这样写不够 — 重新申请按钮
- 应该这样写 — 仅在上一次申请被拒绝时显示重新申请按钮
3. 结果 — 点击后会发生什么
很多时候只有按钮名称，没有后续。保存什么、跳转到哪里、向用户显示什么，这些合起来才是完整的一套。
- 这样写不够 — 确认按钮
- 应该这样写 — 确认 → 保存申请 → 跳转到完成页面 → 显示受理编号
4. 失败 — 不成功时会怎样
这是特别容易遗漏的一项。往往只画出顺利的流程就结束了。但在实际服务中，占用大部分时间的恰恰是不成功时的处理。
- 这样写不够 — （什么都没写）
- 应该这样写 — 网络失败时提示重试 / 重复申请时提示已有申请 / 输入有误时标出对应字段
为什么第4项最重要
功能靠想象就能想出来，失败要亲身经历过才会知道。
所以，失败一项为空的文档，往往意味着这是一个还从未真正运行过的服务。开发公司也看得出来。在这种状态下给出的报价，之后常常会增加，因为没写到的情况会在开发过程中一个个冒出来。
反过来，如果写清了失败处理，报价就会很快出来，因为可以数得清。
在做一款金融科技服务时，我曾负责统筹开放银行（Open Banking）对接。要通过金融机构的审核，仅仅功能能用是不够的，还必须准备好功能测试和安全文档——包括在什么条件下、以什么方式失败，那时显示什么、记录什么。
这个过程很繁琐，但正因为有这份文档，我们以小团队也通过了审核。只要写过一次“填完才能通过”的文档，之后它就会成为你的默认标准。
交付前检查清单
请为每个界面填写下面四行。如果有哪个界面填不满这四行，那里就是日后报价会增加的地方。
界面名称:
____________
1. 状态 — 这个界面可能有哪些状态？（为空 / 加载中 / 完成 / 失败）
2. 条件 — 什么时候出现？
3. 结果 — 用户操作后，保存什么、跳转到哪里？
4. 失败 — 不成功时，显示什么、记录什么？
最好再加上一项：这些数据从哪里来。如果没有写明界面上显示的数字来自哪个系统，开发开始之后，你就会听到“没有这个值”的回答。
交给AI时也一样
如今很多人用AI来写需求初稿。这时条件也是一样的。
如果只说“帮我写界面设计说明书”，得到的只有顺利的流程。因为AI同样想象不出失败。换成下面这样的要求，结果就会不同。
“请把这个界面的状态分成四种，并写出每种状态下用户看到的内容，以及失败时的处理。”
AI擅长的是填补空白的格子。至于要填什么，需要由人来告诉它。
如果今天只做一件事
从你正在做的界面中只挑一个，填写上面的四行。
最快暴露问题的是第4项。如果失败一项是空的，说明这个界面还没有准备好交付。
如果不确定自己的文档是否已经可以交付
通过2分钟诊断，您可以看到当前应优先着手的一个课题、2周试点的启动方案，以及必须由人确认的风险。按您方便的程度作答即可。
注释
① 参考资料·确认日期
本文未引用外部统计或研究。依据是在授课和咨询现场审阅需求文档时反复确认的提问模式（面向准创业者的1:1咨询累计500次以上 · 以履历SSOT为准）。正文中的开放银行案例，是2021年在一家金融科技服务公司（2019.09~2022.06在职）统筹对接的经历。确认日期 2026-08-04。
② 未使用的数据
本文未使用开发周期缩短率、报价节省率之类的数据。因为这些不是我们测量的数值，而且各项目之间差异很大，无法一概而论。公司内部问卷和客服回复中的数据也未使用。
③ 制作方式
由AI生成初稿，经人工核实和编辑。发布前经过了事实、语气、法务3项审核。
Engagement
浏览和互动会保存为内部内容运营指标。
要点
- •拿不到报价，不是因为文档质量差，而是因为没有写出各种情况，工作量无法计算。
- •文档中遗漏的通常是四项：状态（为空·进行中·完成·失败）、条件（什么时候出现）、结果（点击后保存什么、跳转到哪里）、失败（不成功时的处理）。
- •最常遗漏的是失败处理；失败一项为空的文档，往往描述的是还没有真正运行过的服务。
- •如果不写明界面上的数值来自哪个系统（数据来源），开发启动后就会被告知没有这个值。
- •让AI写需求初稿时，同样需要划分状态并一并要求写出失败处理；要填什么，必须由人来告诉它。
常见问题
向外包开发公司询价后，对方回复很慢。应该先补充什么？
建议先检查每个界面是否写明了状态、条件、结果、失败这四项。报价是通过计算要做的东西有多少种情况得出的，缺少这四项就无法计算。尤其是失败处理为空时，报价很容易事后增加。
需求文档要写到什么程度才算足够？
只要开发者无需反问就能做出判断，就足够了。标准是：仅凭文档，能否回答“这个界面什么时候出现、失败了会怎样、这些数据从哪里来”。
可以用AI制作界面设计说明书吗？
用来写初稿是有帮助的。不过直接让它写，往往只会得到顺利的流程，因此最好划分状态，并一并要求写出失败时的处理。决定要填什么，是人的职责。
STAR-T
STAR-T首席顾问
作为IT服务规划和设计专家，我研究并分享来自各种初创公司和企业的成功案例。
立即行动
阅读之后，立即连接到可以执行的服务和咨询。
通过洞察理解问题后，下一步是确定执行结构。可以直接跳转到相关服务或免费咨询。