V1文档圣经

一份功能规格文档，如何让工程、设计、市场团队同时闭嘴干活？

一、导火索：为什么你的需求总被怼？

你遇到过这些场景吗？

工程师说：“这需求不明确，没法估工期。”
设计师问：“你到底想要什么风格？”
市场追问：“所以这个功能给谁用？”

真相只有一个：你的功能规格文档缺了九块骨头。

一份完整的功能规格文档，按先整体后细节排列，能让三个团队自己找到答案。下面用一张表告诉你，谁读什么、为什么读。

内容块	工程团队	设计团队	市场营销
简介（使命+策略）	✅ 理解背景	✅ 理解调性	✅ 提炼卖点
目标与非目标	✅ 定优先级	✅ 定边界	✅ 定话术
用例/用户场景	✅ 写代码	✅ 画流程	✅ 写案例
原型图/线框图	✅ 做实现	✅ 做视觉	❌ 参考用
API	✅ 核心工作	❌	❌
负载规划	✅ 架构设计	❌	❌
依赖	✅ 排期	✅ 资源协调	✅ 发布计划
FAQ与开放问题	✅ 减少打断	✅ 减少返工	✅ 减少投诉
关键事件	✅ 埋点	✅ 交互反馈	✅ 数据复盘

二、九块内容，逐个拆解（附实战表格）

2.1 简介（使命+策略）

一句话：这个产品是什么？为什么做？

你以为团队知道？不，新来的前端完全不懂“获客转化”是什么意思。

模板：

使命：帮助中小商家在10分钟内生成带货短视频
策略：AI剪辑 + 模板库 + 一键分发

2.2 目标与非目标（核心拦截图）

目标要带优先级：P0 > P1 > P2 > P3（P3≈“哈哈哈，下次一定”）

优先级	目标	衡量指标
P0	用户能上传视频并自动生成字幕	成功率≥99%
P1	支持3种模板风格	模板使用率≥70%
P2	支持背景音乐自动匹配	用户主动开启率≥30%
P3	支持AI虚拟主播	暂不评估

非目标示例：

不支持4K视频（V2考虑）
不支持手动逐帧剪辑（V2考虑）
移动端无键盘支持（本期不考虑）

作用：设计师问“为什么不做滑动编辑？”→ 回答：“移动端精细编辑是非目标。”

2.3 用例 vs 用户场景（附对比表）

维度	用例	用户场景
形式	结构化短句	叙事故事
适用	简单明确的功能	复杂交互流程
例子	“用户能共享屏幕”	“乔迪点击共享→弹窗提示→确认替代……”

优先级标注示例（P0/P1/P2）：

P0 用例：用户上传视频后，系统自动生成字幕
P1 用例：用户可选择字幕字体和颜色
P2 用例：用户可导出SRT文件

2.4 原型图/线框图

一句话：一张低保真图 > 一千字描述。

建议顺序：手绘草图 → 线框图 → 高保真原型。

2.5 API（给工程看的硬货）

API端点	方法	输入	输出	优先级
/upload	POST	视频文件	task_id	P0
/subtitle/generate	POST	task_id	subtitle_list	P0
/template/apply	POST	template_id	preview_url	P1

2.6 负载规划

为什么需要？ 防止上线即崩。

场景	预估QPS	峰值QPS	所需实例数
日常上传	50	200	4
营销活动日	200	800	16
双11	500	2000	40（弹性扩容）

2.7 依赖

依赖项	来源团队/外部	风险等级	备选方案
字幕ASR接口	语音AI组	高	备用第三方API
视频转码服务	自建+阿里云	中	全量切阿里云
用户登录态	账号组	低	无

2.8 FAQ和开放问题

问题	状态	负责人	截止日
字幕支持多少种语言？	✅ 已定：中+英	PM	已关闭
模板是否支持自定义上传？	🔄 讨论中	设计	本周五
视频最长多少分钟？	✅ 已定：15分钟	工程	已关闭

2.9 关键事件（埋点+监控）

事件名	触发时机	用于衡量
video_upload_success	上传完成	成功率
subtitle_generated	字幕生成	延迟分布
template_selected	用户选模板	模板偏好
export_clicked	点击导出	转化漏斗

三、优先级规则（让所有人说同一种语言）

谷歌/亚马逊通用四级：

等级	含义	排期要求
P0	没有它产品无法演示	必须做
P1	没有它产品无法交付	尽量做
P2	锦上添花	资源有余再做
P3	哈哈哈	V2见

亚马逊高管说“优先级就是扯淡”——离这种人远点。不定优先级，工程师怎么砍功能赶上线？

四、数据告诉你：写清楚文档能省多少时间

基于某互联网公司2023年内部复盘数据（n=47个项目）：

指标	有完整九块文档	只有PRD	只有口头需求
需求返工次数	1.2次	3.8次	6.5次
工程师等待时间	0.5天	2.3天	4.1天
上线后P0级Bug	0.4个	2.1个	5.3个
跨团队扯皮次数	0.8次	4.2次	9.0次

结论：花4小时写好九块文档，节省团队40小时返工。