为什么经典需求说明书会失败
传统需求说明书有一个结构性缺陷:它描述的是想象中的工具,而非真实的业务。人们在其中罗列屏幕、按钮和需求(“系统应当允许……”),却没有先厘清唯一要紧的事:存在哪些数据、它们如何关联、由谁让它们运转。
所有信息化项目都熟知的结果:交付的工具符合文档却不适应现场——因为文档本身就是虚构。而它的撰写耗费了数周,却没有产出任何软件。
一页式结构:四个板块
一个管理应用完全可以用四个板块来描述。这正是资深设计者所用的结构——也正是 Blueprint Maker 从你的描述中提取、用以构建应用方案的东西。
- 东西(实体):你所跟踪的对象——客户、工地、物品、作业。3 到 8 个名称的清单,每个都带有其关键信息(字段)。
- 关联(关系):东西之间如何联系——“一个工地属于一个客户”“一次作业涉及一台设备”。每条关联一句话。
- 状态(阶段):你的对象的生命周期——“报价、已签、进行中、已完成、已开票”。用你自己的措辞,按真实顺序排列。
- 数字(指标):你希望每天早上看到的——待开票金额、逾期档案、低于阈值的库存。三到六个指标。
完整示例:一页足矣
“围栏安装公司,4 人。东西:客户(姓名、地址、电话)、工地(地址、围栏类型、米数、报价金额、计划日期)、作业(日期、耗时、班组)、材料(编号、库存)。关联:一个工地属于一个客户;一次作业在一个工地上进行;材料按工地消耗。工地的状态:报价已发、已签、已排期、进行中、已完成、已开票、已结清。数字:进行中的工地、本月已安装米数、待开票金额、低于阈值的材料。”
这一页包含了构建应用所需的一切——无论由开发者还是由生成器来做。它不包含的内容同样意味深长:没有屏幕描述、没有技术选型、没有编号需求。屏幕由结构推导而来。
撰写的三个陷阱
陷阱一——描述现有工具:“我想要我表格里从 A 到 R 的那些列”。表格是信息来源,而非目标:从中提取东西和关联,而不是布局。
陷阱二——贪多求全的范围:想要涵盖合规开票、工资、会计。这些受监管的领域自有其工具;你的应用在它们开始的地方止步,并在你的运营跟踪上表现出色。
陷阱三——先谈特殊情况:“那如果一个客户同时也是供应商呢?”。先描述覆盖 90 % 日常的正常流程;特殊情况随后再在健康的结构之上添加。
从一页到应用:两条路径
经典路径:这一页作为给开发者或代理机构的简报——它大幅降低误解风险和计费的需求梳理时间。
直接路径:这一页就是提示词。交给 Blueprint Maker,它便成为一份结构化的应用方案——实体、关系、状态、指标——你在生成前加以确认。应用交付时已部署,并带有演示数据:你的需求说明书是在真实屏幕上核验,而非在验收会议里。而若日后有开发者介入,他从生成的代码起步(ZIP 导出、GitHub 推送),而非从一张白纸开始。
可复制的模板
拿起这四行,用你自己的话填入:“我的业务:…… 所跟踪的东西(含其关键信息):…… 它们之间的关联:…… 所经历的状态:…… 每天早上要看的数字:……” 十行足矣;探索方案(0 €)让你立即测试你的这一页会产出怎样的应用。