需求文档 · 规范
产品仅支持英语(en-US)、日语(ja-JP)、繁体中文(zh-TW)、韩语(ko-KR)四种语言。zh-CN 已废弃,明确不支持,不计入文案表、demo 选项或测试覆盖;工作台说明仍使用简体中文。
截图与标注
- 截图来自打包好的 demo,不用设计稿替代
- 默认手机尺寸(390×844);桌面端有差异时再加桌面截图
- 每个功能点一个序号,序号必须在需求明细里有对应条目(生成时会自动校验)
- 需要操作后才出现的界面(弹窗、展开状态)单独截一张
需求明细写法
| 字段 | 要求 | 好的例子 | 不好的例子 |
|---|---|---|---|
| 做什么 | 具体到用户看到什么、能做什么 | 点击 × 后提示条立即消失 | 支持关闭 |
| 不做什么 | 必须写,划清边界 | 不同步到账号;不提供重新显示入口 | (空着不写) |
| 验收标准 | 可观察、可验证,能被场景测试用例覆盖 | 刷新页面后提示条仍不出现 | 体验流畅 |
其他要求
只列需求新增产品文案:历史 key、复用历史文案、演示辅助文案均排除。与基线核对 key 并按需求范围分类,不扫描整份字典罗列,也不把换了命名空间的历史文案当成新增。
demo 确认后,需求文档最后附「新增国际化文案」表,列出与基线比较的全部新增 key、使用位置及项目全部语言的翻译。缺翻译先补齐,归档后保留文案快照,无新增时明确说明。
- 用产品语言写,不写代码细节
- 「本期不做」写清楚延后的部分,避免研发误做
- 模拟数据要说明:demo 不涉及服务端,研发需要知道哪些要接接口
- 没想清楚的写进「待确认问题」,不要含糊带过
- 每次修改都记录在变更记录里
- 不手改
index.html,改内容让 AI 改prd.json后重新生成