夜雨聆风
一份功能规格文档，如何让工程、设计、市场团队同时闭嘴干活？
一、导火索：为什么你的需求总被怼？
你遇到过这些场景吗？
工程师说：“这需求不明确，没法估工期。”
设计师问：“你到底想要什么风格？”
市场追问：“所以这个功能给谁用？”
真相只有一个：你的功能规格文档缺了九块骨头。
一份完整的功能规格文档，按先整体后细节排列，能让三个团队自己找到答案。下面用一张表告诉你，谁读什么、为什么读。
| 内容块 | 工程团队 | 设计团队 | 市场营销 |
|---|---|---|---|
| 简介（使命+策略） | ✅ 理解背景 | ✅ 理解调性 | ✅ 提炼卖点 |
| 目标与非目标 | ✅ 定优先级 | ✅ 定边界 | ✅ 定话术 |
| 用例/用户场景 | ✅ 写代码 | ✅ 画流程 | ✅ 写案例 |
| 原型图/线框图 | ✅ 做实现 | ✅ 做视觉 | ❌ 参考用 |
| 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小时返工。
