@chantezy/mcp-product-design 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. package/dist/index.js +6 -1
  2. package/dist/index.js.map +1 -1
  3. package/package.json +1 -1
  4. package/skills/b-design-diverge/README.md +92 -0
  5. package/skills/b-design-diverge/SKILL.md +129 -0
  6. package/skills/b-design-diverge/references/b-design-patterns.md +78 -0
  7. package/skills/b-design-diverge/references/component-libraries.md +66 -0
  8. package/skills/b-design-diverge/references/output-example.md +167 -0
  9. package/skills/b-design-diverge/references/wireframe-symbols.md +114 -0
  10. package/skills/interaction-design-eval/README.md +55 -0
  11. package/skills/interaction-design-eval/SKILL.md +156 -0
  12. package/skills/interaction-design-eval/references/job_level_standards.md +134 -0
  13. package/skills/interaction-design-eval/references/scoring_criteria.md +210 -0
  14. package/skills/interaction-spec/README.md +55 -0
  15. package/skills/interaction-spec/SKILL.md +253 -0
  16. package/skills/interaction-spec/references/complete-examples.md +97 -0
  17. package/skills/interaction-spec/references/interactive-checklist.md +367 -0
  18. package/skills/prd-generator/README.md +54 -0
  19. package/skills/prd-generator/SKILL.md +120 -0
  20. package/skills/prd-generator/references/prd-template.md +99 -0
  21. package/skills/requirements-content-analysis/README.md +103 -0
  22. package/skills/requirements-content-analysis/SKILL.md +791 -0
  23. package/skills/requirements-content-analysis/references/Cognitive Psychology.md +207 -0
  24. package/skills/requirements-content-analysis/references/Interaction-design-principles.md +264 -0
  25. package/skills/requirements-content-analysis/references/Multi-Platform Design Principles.md +340 -0
  26. package/skills/test-skill/SKILL.md +0 -23
  27. package/skills/test-skill/references/test-ref.md +0 -3
@@ -0,0 +1,367 @@
1
+ # 交互说明自查规范
2
+
3
+ > 本文档用于:
4
+ > 1. **撰写交互说明时的结构参照**——确保说明文档覆盖所有必要维度
5
+ > 2. **交互说明完善性评审**——逐条检查是否存在遗漏,可直接作为走查 checklist 使用
6
+
7
+ ---
8
+
9
+ ## 使用说明
10
+
11
+ - ✅ 已在交互说明中覆盖
12
+ - ⚠️ 部分覆盖(需补充)
13
+ - ❌ 未覆盖(需补写)
14
+ - N/A 不适用于当前项目
15
+
16
+ ---
17
+
18
+ ## 一、目标分析
19
+
20
+ > 在开始任何交互设计前,需先确认以下目标是否有明确定义。
21
+
22
+ | 检查维度 | 检查点 | 说明 | 状态 |
23
+ |---|---|---|---|
24
+ | 业务目标 | 想要实现怎样的目标和成果?驱动动机是什么? | 根据具体项目内容设定,但一定要搞清楚 | |
25
+ | 用户目标 | 针对什么用户?在什么场景?解决什么问题?达到什么目的? | | |
26
+ | 产品目标 | 能否用一句可衡量的话描述? | | |
27
+ | 设计目标 | 是否提炼了 1~3 个关键词并进行了解读分析? | 根据以上三个目标提炼 | |
28
+
29
+ ---
30
+
31
+ ## 二、整体结构与信息架构
32
+
33
+ | 检查维度 | 检查点 | 说明 | 状态 |
34
+ |---|---|---|---|
35
+ | 结构可理解性 | 是否提供了用户熟悉的结构和布局? | | |
36
+ | 信息层级 | 页面之间的关系是否清楚(主次关系 / 从属关系)? | 不同页面间的关系是否一致?如有差异,是否说明了原因? | |
37
+ | 信息分类 | 信息组织是否具有逻辑性?不同类型的信息区分是否清晰? | | |
38
+ | 主题清晰度 | 用户能在 3 秒内明白「我在哪里」? | | |
39
+ | 目的明确性 | 用户能在 3 秒内明白「我可以做什么」? | | |
40
+ | 重点突出 | 最需要用户关注的内容是否放在最显眼的位置? | | |
41
+ | 可扩展性 | 后续框架与内容扩展时,当前设计能否支撑? | | |
42
+
43
+ ---
44
+
45
+ ## 三、用户角色与权限
46
+
47
+ | 检查维度 | 检查点 | 说明 | 状态 |
48
+ |---|---|---|---|
49
+ | 角色类型梳理 | 产品中共有多少种用户类型?每种用户是否清楚自己的任务? | | |
50
+ | 普通用户 | 体验和呈现内容上是否有特殊处理? | | |
51
+ | VIP 用户 | 与普通用户的差异点是否说明清楚? | | |
52
+ | 内网用户 / 外网用户 | 访问权限差异是否覆盖? | | |
53
+ | 管理员视图 | 管理员专属功能和视图是否单独说明? | | |
54
+ | 角色转变 | 不同角色之间能否相互转变?操作流程和条件是否清楚?角色变更后是否有通知机制? | | |
55
+
56
+ ---
57
+
58
+ ## 四、账号体系
59
+
60
+ | 检查维度 | 检查点 | 状态 |
61
+ |---|---|---|
62
+ | 登录方式 | 支持哪些登录方式?是否有多端差异? | |
63
+ | 注册流程 | 如何注册?流程是否完整? | |
64
+ | 账号同步 | 不同类型账户 / 同账户不同终端间的数据是否同步? | |
65
+
66
+ ---
67
+
68
+ ## 五、流程完整性
69
+
70
+ | 检查维度 | 检查点 | 说明 | 状态 |
71
+ |---|---|---|---|
72
+ | 路径一致性 | 从 A 到 B 的路径是否一致? | | |
73
+ | 逆向流程 | 返回和出入口是否符合用户预期?跳转名称与目的地内容是否一致? | 例:点击前叫「个人资料」,点击后显示「个人中心」——是否一致? | |
74
+ | 流程闭环 | 流程能否完整闭环?是否存在死口短路的现象? | | |
75
+ | 流程中断 | 任务过程中中断后如何提醒?恢复后如何提醒? | 电话打入、网络断开、主动退出等各类中断情况 | |
76
+ | 操作容错 | 放弃填写后是否保留之前输入的内容(「保留案发现场」)? | | |
77
+ | 视觉动线 | 页面内的视觉引导方向是否符合操作逻辑? | | |
78
+
79
+ ---
80
+
81
+ ## 六、内容与数据规范
82
+
83
+ ### 6.1 数据获取
84
+
85
+ | 检查维度 | 检查点 | 状态 |
86
+ |---|---|---|
87
+ | 数据来源 | 数据从哪里获取(系统抓取 / 用户上传)? | |
88
+ | 获取方式 | 自动更新还是手动加载? | |
89
+ | 权限 | 数据获取是否需要授权? | |
90
+
91
+ ### 6.2 缓存策略
92
+
93
+ | 检查维度 | 检查点 | 状态 |
94
+ |---|---|---|
95
+ | 临时缓存 | 是否说明了临时缓存的处理方式? | |
96
+ | 可删除缓存 | 用户能否主动清除缓存? | |
97
+ | 永久缓存 | 哪些数据永久保存? | |
98
+ | 首次加载 | 首次使用时的加载情况是否说明? | |
99
+ | 非首次加载 | 非首次使用时的缓存命中情况是否说明? | |
100
+
101
+ ### 6.3 内容状态
102
+
103
+ | 状态 | 说明 | 是否覆盖 |
104
+ |---|---|---|
105
+ | 初始状态 | 页面/组件进入时的默认呈现 | |
106
+ | 空状态 | 没有任何内容时的展示方式(空图 + 文案 + 引导操作) | |
107
+ | 常规状态 | 有数据时的正常展示 | |
108
+ | 中间状态 | 加载中、处理中等过渡状态 | |
109
+ | 内容过期 | 数据超时或过期后的展示逻辑 | |
110
+
111
+ ### 6.4 显示规则
112
+
113
+ | 检查维度 | 检查点 | 说明 | 状态 |
114
+ |---|---|---|---|
115
+ | 边界值 | 最大值、最小值及各种极限情况 | | |
116
+ | 非最优展示 | 极端数据下的展示是否合理? | 例:饼图占比仅 0.1% 时如何展示 | |
117
+ | 重复与缺失 | 是否存在内容重复或字段缺失的情况? | | |
118
+
119
+ ---
120
+
121
+ ## 七、内容异常处理
122
+
123
+ | 异常场景 | 检查点 | 状态 |
124
+ |---|---|---|
125
+ | 敏感词 / 违规内容 | 用户输入违规内容时如何处理? | |
126
+ | 无法获取数据 | 接口返回失败或无数据时的兜底方案 | |
127
+ | 加载时间过长 | 超时阈值是多少?超时后如何提示? | |
128
+ | 错误提示 | 404、系统繁忙、服务器错误等标准错误页是否有说明? | |
129
+
130
+ ---
131
+
132
+ ## 八、反馈与通知
133
+
134
+ ### 8.1 系统通知
135
+
136
+ | 检查维度 | 检查点 | 说明 | 状态 |
137
+ |---|---|---|---|
138
+ | 通知方式 | 是否支持多种通知方式(邮件 / 短信 / 微信 / App Push)? | | |
139
+ | 推送来源 | 调用系统通知还是第三方服务?是否需要授权? | | |
140
+ | 推送策略 | 推送时间、表现形式、失效规则是否定义? | | |
141
+ | 退订机制 | 是否支持用户退订通知? | | |
142
+
143
+ ### 8.2 界面操作反馈
144
+
145
+ | 检查维度 | 检查点 | 说明 | 状态 |
146
+ |---|---|---|---|
147
+ | 操作成功提示 | 操作成功后的反馈文案和展示方式 | 弱提示(Toast)还是强提示(弹窗)? | |
148
+ | 操作失败提示 | 操作失败后的反馈文案和展示方式 | 接下来引导用户做什么? | |
149
+ | 异常中断提示 | 任务异常中断后如何提示?引导用户做什么? | | |
150
+ | 强制中断提示 | 是否有必要强制中断当前操作?弹窗内容是什么? | | |
151
+ | 公告 / 引导提示 | 是否需要用户主动操作后才消失? | | |
152
+ | 错误纠正 | 是否有搜索纠错等容错提示? | 例:搜索「指派屋」提示「你是否在找:纸牌屋」 | |
153
+ | 反馈形式 | 是否需要声音或震动反馈? | | |
154
+ | 反馈位置 | 提示位置是否显眼?各页面提示位置是否一致? | | |
155
+
156
+ ### 8.3 用户主动反馈
157
+
158
+ | 检查维度 | 检查点 | 状态 |
159
+ |---|---|---|
160
+ | 反馈入口 | 是否提供了意见反馈入口(客服 / 在线反馈)? | |
161
+ | 反馈方式 | 支持哪些反馈方式? | |
162
+
163
+ ---
164
+
165
+ ## 九、特殊场景考虑
166
+
167
+ ### 9.1 设备与硬件
168
+
169
+ | 检查维度 | 检查点 | 状态 |
170
+ |---|---|---|
171
+ | 横竖屏 | 横竖屏切换时布局是否正常? | |
172
+ | 分辨率 | 各种分辨率下如何显示?最大最小极限情况是否考虑? | |
173
+ | 不同设备 / 版本 | 不同操作系统版本、不同设备型号是否有说明? | |
174
+ | 硬件调用 | 是否需要调用蓝牙、定位、相机、话筒等?是否需要授权? | |
175
+ | 硬件联动 | 是否需要与打印机等其他硬件联动? | |
176
+
177
+ ### 9.2 异常操作
178
+
179
+ | 检查维度 | 检查点 | 说明 | 状态 |
180
+ |---|---|---|---|
181
+ | 恶意 / 高频操作 | 反复快速点击时如何处理? | 防重复提交、节流策略 | |
182
+
183
+ ### 9.3 中断情况
184
+
185
+ | 中断类型 | 检查点 | 状态 |
186
+ |---|---|---|
187
+ | 硬件中断 | 没电、设备关机等情况下如何处理? | |
188
+ | 软件中断 | 电话打入、通知弹出、系统弹窗等 | |
189
+ | 用户主动取消 | 任务流程中用户能否主动中断?中断后数据如何处理? | |
190
+
191
+ ### 9.4 网络状态
192
+
193
+ | 网络状态 | 检查点 | 状态 |
194
+ |---|---|---|
195
+ | 有网络 | 正常情况下的加载和交互 | |
196
+ | 无网络 | 断网时的提示和降级方案 | |
197
+ | 弱网 / 慢网 | 网络信号不佳时的处理方式 | |
198
+ | Wi-Fi 与流量切换 | 切换时是否需要提示用户? | |
199
+ | 连接超时 | 超时阈值设定与提示方式 | |
200
+
201
+ ### 9.5 特殊模式
202
+
203
+ | 模式 | 是否考虑 |
204
+ |---|---|
205
+ | 无图模式(图片加载失败)| |
206
+ | 夜间模式 | |
207
+ | 低电量模式 | |
208
+ | 沉浸模式 | |
209
+
210
+ ### 9.6 刷新与加载
211
+
212
+ | 检查维度 | 检查点 | 状态 |
213
+ |---|---|---|
214
+ | 手势刷新 | 下拉刷新是否支持?动效是否定义? | |
215
+ | 点击刷新 | 手动触发刷新按钮的行为 | |
216
+ | 自动刷新 | 自动刷新的时间间隔和触发条件 | |
217
+ | 加载数量 | 每次加载多少条数据?分页还是无限滚动? | |
218
+
219
+ ### 9.7 容错与防错
220
+
221
+ | 检查维度 | 检查点 | 状态 |
222
+ |---|---|---|
223
+ | 危险操作二次确认 | 删除、清空、不可逆操作是否有二次确认? | |
224
+ | 撤销机制 | 操作是否支持撤销(Undo)?撤销时间窗口是多少? | |
225
+ | 自动保存 | 中断后是否自动保存用户数据? | |
226
+
227
+ ---
228
+
229
+ ## 十、文本与控件规范
230
+
231
+ ### 10.1 图文规范
232
+
233
+ | 检查维度 | 检查点 | 状态 |
234
+ |---|---|---|
235
+ | 图文模式一致性 | 所有图文展示模式是否统一? | |
236
+ | 图片为空 | 图片加载失败或无图时的兜底展示 | |
237
+ | 内容不存在 | 对应内容被删除或不存在时的展示逻辑 | |
238
+ | 内容过期 | 内容超期后的展示方式 | |
239
+
240
+ ### 10.2 控件规范
241
+
242
+ | 检查维度 | 检查点 | 说明 | 状态 |
243
+ |---|---|---|---|
244
+ | 控件一致性 | 整个产品的控件 / 组件是否保持一致(提示、弹窗、对话框、气泡等)? | | |
245
+ | 控件语义 | 控件操作表意是否清晰?图标和颜色是否符合使用标准? | | |
246
+ | 默认选项 | 控件是否有合理的默认值? | | |
247
+ | 控件展开后的操作 | 控件点开后的交互是否有完整说明? | 最容易被忽略的部分 | |
248
+
249
+ ### 10.3 文本规范
250
+
251
+ | 检查维度 | 检查点 | 说明 | 状态 |
252
+ |---|---|---|---|
253
+ | 用语一致性 | 语言表述是否统一(提示用语、称谓、菜单命令、标点格式、产品功能名称)? | | |
254
+ | 简洁准确 | 文字表达是否简洁准确通俗易懂?关键信息是否放在前面?是否去掉了专业术语? | | |
255
+ | 实用性 | 是否符合操作场景?能否明确引导下一步操作? | | |
256
+ | 文本温度 | 是否以用户视角出发?文案风格是否恰当? | | |
257
+
258
+ ---
259
+
260
+ ## 十一、常见组件状态检查
261
+
262
+ ### 11.1 按钮
263
+
264
+ | 状态 | 是否覆盖 |
265
+ |---|---|
266
+ | 正常态 | |
267
+ | 悬停态(Hover) | |
268
+ | 按压态(Active) | |
269
+ | 按下后弹起态 | |
270
+ | Loading 态(防重复提交) | |
271
+ | 不可点击 / 禁用态 | |
272
+
273
+ ### 11.2 输入框
274
+
275
+ | 状态 | 检查点 | 是否覆盖 |
276
+ |---|---|---|
277
+ | 默认态 | 是否有默认值或占位提示(Placeholder)? | |
278
+ | 输入中状态 | 是否提供实时提示或验证反馈? | |
279
+ | 输入错误状态 | 文本长度是否有限制?字符标准是什么?错误如何高亮? | |
280
+ | 输入正确状态 | 校验通过后是否有正向反馈? | |
281
+ | 键盘操作 | 回车键是否等同于「确认」操作? | |
282
+ | 禁用态 | 无法输入时的展示样式 | |
283
+ | 清空操作 | 有内容时是否显示清空按钮?点击是否聚焦? | |
284
+
285
+ ### 11.3 列表
286
+
287
+ | 检查维度 | 检查点 | 是否覆盖 |
288
+ |---|---|---|
289
+ | 空状态展示 | 空图 + 文案 + 引导操作 | |
290
+ | 默认显示数量 | 每页显示多少条?字段过长如何截断? | |
291
+ | 默认排序规则 | 按时间 / 热度 / 其他排序? | |
292
+ | 图片为空的展示 | | |
293
+ | 内容过期 / 不存在的展示 | | |
294
+ | 加载 / 翻页操作 | 分页 / 无限滚动 / 「加载更多」按钮? | |
295
+ | 多种排列方式 | 是否支持大图、小图、图文切换? | |
296
+ | 列表操作 | 筛选、搜索、多选、批量操作等 | |
297
+ | 鼠标经过状态 | 经过图片或文字时的视觉变化 | |
298
+
299
+ ### 11.4 加载状态
300
+
301
+ | 状态 | 检查点 | 是否覆盖 |
302
+ |---|---|---|
303
+ | 加载中(正常) | Loading 样式(骨架屏 / Spinner / 进度条) | |
304
+ | 加载中(异常) | 网络错误、操作错误时如何提醒 | |
305
+ | 加载后 | 加载完成后的过渡处理 | |
306
+ | 加载成功 | 成功后的视觉状态 | |
307
+ | 加载失败 | 失败后的重试机制 | |
308
+ | 加载时间过长 | 超时提醒方式 | |
309
+ | 加载中可否取消 | 是否提供取消按钮 | |
310
+ | 单页面加载 | 一次性加载全部数据的场景 | |
311
+ | 异步加载 | 单页面多模块分批加载 | |
312
+ | 预加载 | 跨页面预加载策略 | |
313
+
314
+ ### 11.5 登录流程
315
+
316
+ | 检查维度 | 检查点 | 是否覆盖 |
317
+ |---|---|---|
318
+ | 多种登录方式 | 是否支持多种方式? | |
319
+ | 密码错误限制 | 是否有错误次数显示?超出限制如何处理? | |
320
+ | 忘记密码 | 找回方式是否完整? | |
321
+ | 登录前状态 | 未登录时各页面的展示逻辑 | |
322
+ | 登录中(正常)| 登录过程中的 Loading 展示 | |
323
+ | 登录中(异常)| 发生异常时的提醒 | |
324
+ | 登录后 | 是否跳回登录前的页面?还是刷新至首页? | |
325
+
326
+ ### 11.6 表单 / 填写申请
327
+
328
+ | 检查维度 | 检查点 | 是否覆盖 |
329
+ |---|---|---|
330
+ | 字段唯一性 | 是否允许和其他用户的字段重复? | |
331
+ | 填写中的错误提示 | 实时校验还是提交时校验?提示位置和样式? | |
332
+ | 提交后 | 后台收到什么?需要谁处理? | |
333
+ | 提交后通知 | 通过什么方式告知申请人结果(邮件 / 站内信等)? | |
334
+
335
+ ---
336
+
337
+ ## 十二、品牌与社会责任
338
+
339
+ | 检查维度 | 检查点 | 状态 |
340
+ |---|---|---|
341
+ | 社会责任感 | 内容与功能是否考虑到对社会的影响? | |
342
+ | 情感设计 | 交互过程是否有情感化表达? | |
343
+ | 趣味性 | 是否有适当的趣味性设计? | |
344
+ | 品牌传达 | 是否与品牌调性一致? | |
345
+ | 商业性 | 商业目标与用户体验是否平衡? | |
346
+
347
+ ---
348
+
349
+ ## 附:快速自查 TOP 15(高频遗漏项)
350
+
351
+ > 以下是交互说明中最容易忽略的问题,优先逐一排查:
352
+
353
+ 1. **空状态** — 列表、搜索结果、个人中心等是否都有空态设计?
354
+ 2. **加载失败** — 每个接口请求失败时的兜底方案是否覆盖?
355
+ 3. **权限差异** — 不同角色看到的页面和功能差异是否全部说明?
356
+ 4. **控件展开后的操作** — 弹窗、抽屉、下拉菜单点开后的交互是否完整?
357
+ 5. **流程中断与恢复** — 任务过程中被打断,恢复后从哪里继续?
358
+ 6. **逆向流程** — 返回、取消、关闭后的状态和跳转是否符合预期?
359
+ 7. **边界值** — 最长文本、最大数量、最小金额等极限情况下的展示?
360
+ 8. **操作容错** — 用户误操作或放弃时,数据是否被保留?
361
+ 9. **按钮禁用态** — 何时禁用、何时恢复?禁用时是否有 Tooltip 说明原因?
362
+ 10. **网络异常** — 断网、弱网、超时的不同处理方式是否分别说明?
363
+ 11. **危险操作二次确认** — 删除、清空、不可逆操作是否有确认弹窗?
364
+ 12. **跳转名称一致性** — 点击前后的页面名称是否一致?
365
+ 13. **通知授权** — 需要推送通知时,授权拒绝后的降级方案?
366
+ 14. **输入框键盘行为** — 回车、Tab、Esc 等键盘操作是否有对应处理?
367
+ 15. **内容过期** — 过期内容的展示方式和提示文案是否定义?
@@ -0,0 +1,54 @@
1
+ # PRD 需求文档生成 Skill
2
+
3
+ 产品需求文档(PRD)生成技能。`
4
+
5
+ ## 功能
6
+
7
+ 帮助产品经理创建清晰、可操作的需求文档,包括:
8
+
9
+ - 结构化的需求收集工作流程
10
+ - PRD 最佳实践指导
11
+ - 完整的需求文档模板
12
+ - 中英文双语支持
13
+
14
+ ## 使用场景
15
+
16
+ 当用户请求以下内容时触发:
17
+
18
+ - "创建 PRD"
19
+ - "写产品需求文档"
20
+ - "帮我写一个功能需求"
21
+ - "Create a PRD for..."
22
+ - 任何与产品需求相关的请求
23
+
24
+
25
+ ## 使用方法
26
+
27
+ 直接请求生成 PRD:
28
+
29
+ ```
30
+ 帮我创建一个用户认证功能的 PRD
31
+ ```
32
+
33
+ 或
34
+
35
+ ```
36
+ Create a PRD for dark mode feature
37
+ ```
38
+
39
+ ## 目录结构
40
+
41
+ ```
42
+ skills-prd-generator/
43
+ ├── SKILL.md # 技能主文件
44
+ ├── references/
45
+ │ └── prd-template.md # PRD 模板
46
+ └── README.md # 本文件
47
+ ```
48
+
49
+ ## 工作流程
50
+
51
+ 1. **收集背景信息** - 通过发现式对话获取需求
52
+ 2. **生成结构** - 按照标准PRD结构组织内容
53
+ 3. **输出文档** - 生成 Markdown 格式的完整 PRD
54
+
@@ -0,0 +1,120 @@
1
+ ---
2
+ name: prd-generator
3
+ description: 当用户要求创建产品要求文档 (PRD) 时,应使用此技能,例如“为功能 X 创建 PRD”、“编写产品要求文档”、“帮我创建 PRD”或任何涉及编写产品要求规范的请求。 它为收集需求和生成全面的PRD文档提供了结构化的工作流程。
4
+ ---
5
+
6
+ # PRD 需求文档生成
7
+
8
+ ## 概述
9
+
10
+ 生成全面、结构清晰的产品需求文档(PRD),遵循行业最佳实践。本技能帮助产品经理创建清晰、可操作的需求文档,协调各方利益相关者并指导开发团队。
11
+
12
+ ## 核心工作流程
13
+
14
+ 当用户请求创建 PRD 时(例如:"为用户认证功能创建 PRD"、"帮我写一个PRD"),请遵循以下工作流程:
15
+
16
+ ### 步骤 1:收集背景信息
17
+
18
+ 在生成 PRD 之前,通过发现式对话收集必要信息:
19
+
20
+ **必要信息:**
21
+ - **功能/产品名称**:我们要构建什么?
22
+ - **问题陈述**:这能解决什么问题?
23
+ - **目标用户**:这是给谁用的?
24
+ - **业务目标**:我们想要实现什么?
25
+ - **成功指标**:我们将如何衡量成功?
26
+
27
+ **需要询问的问题:**
28
+
29
+ ```
30
+ 1. 您想要解决什么问题?
31
+ 2. 这个功能的主要用户/受众是谁?
32
+ 3. 关键的业务目标是什么?
33
+ 4. 有什么技术限制我们需要了解的吗?
34
+ 5. 成功是什么样的?如何衡量?
35
+ ```
36
+
37
+ **注意:** 如果用户提前提供了详细的简报或需求,您可以跳过一些问题。始终对缺失的关键信息进行澄清。
38
+
39
+ ### 步骤 2:生成 PRD 结构
40
+
41
+ PRD 包括以下部分,如果不需要的内容可以省略,如果有好的表述方式也可以自己规划,但要注意不要重复内容进行描述,要尽量简洁通俗易懂:
42
+
43
+ 1. **一、需求背景** - 需要解决的问题及背景,问题的清晰表述,我们为谁处理,要做到什么程度
44
+ 2. **二、功能范围** - 功能影响范围及衍生情况的考虑,范围内和范围外的内容
45
+ 3. **三、业务流程** - 用户、功能流程简述
46
+ 4. **四、需求详情** - 详细的功能需求
47
+ 5. **五、操作流程** - 用户操作路径
48
+ 6. **六、相关需求链接** - (用户自己填写)
49
+
50
+ ### 步骤 3:输出 PRD
51
+
52
+ 将收集的信息按照结构模板生成 Markdown 格式的 PRD 文档。
53
+
54
+ ## PRD 模板
55
+
56
+ 使用 `references/prd-template.md` 作为基础模板,根据实际需求调整内容。
57
+
58
+ ## 最佳实践
59
+
60
+ ### 编写高质量需求
61
+
62
+ **好的需求应该:**
63
+ - **具体**:清晰明确
64
+ - **可衡量**:可以验证/测试
65
+ - **可实现**:技术可行
66
+ - **相关**:与用户/业务价值相关
67
+
68
+ **避免:**
69
+ - 模糊语言("快速"、"简单"、"直观")
70
+ - 实施细节(让程序员决定如何做)
71
+ - 范围蔓延(坚持核心需求)
72
+ - 未经验证的假设
73
+
74
+ ### 范围管理
75
+
76
+ **范围内部分:**
77
+ - 列出包含的特定功能/能力
78
+ - 明确且详细
79
+
80
+ **范围外部分:**
81
+ - 明确说明不包括什么
82
+ - 防止范围蔓延
83
+ - 管理利益相关者的期望
84
+ - 可以包含"未来考虑"
85
+
86
+ ## 使用模式
87
+
88
+ ### 模式 1:新功能 PRD
89
+
90
+ **用户请求:** "为我们的移动应用添加深色模式创建 PRD" 或 "帮我写一个深色模式的需求文档"
91
+
92
+ **执行:**
93
+ 1. 询问关于深色模式需求的发现式问题
94
+ 2. 使用模板生成 PRD
95
+
96
+ ### 模式 2:功能优化 PRD
97
+
98
+ **用户请求:** "编写改进我们搜索功能的需求"
99
+
100
+ **执行:**
101
+ 1. 收集当前搜索限制的背景信息
102
+ 2. 识别用户痛点和期望的改进
103
+ 3. 生成聚焦于以下内容的 PRD:
104
+ - 当前状态分析
105
+ - 拟议的增强功能
106
+ - 影响评估
107
+
108
+ ## 验证清单
109
+
110
+ 在最终确定 PRD 之前,验证:
111
+
112
+ - [ ] **问题清晰**:任何人都能理解我们要解决什么
113
+ - [ ] **用户已确定**:我们知道这是给谁的
114
+ - [ ] **成功可衡量**:我们能判断它是否有效
115
+ - [ ] **范围有界限**:明确范围内外
116
+
117
+ ## 输出格式
118
+
119
+ 将上面内容考虑清楚,最后要输出为 **Markdown** 格式的文档。
120
+
@@ -0,0 +1,99 @@
1
+ # PRD 模板
2
+
3
+ ## [功能名称]-PRD需求文档
4
+
5
+ ## **一、需求背景**
6
+
7
+ **目标:** [我们要实现什么]
8
+
9
+ **现状:** [当前存在的问题或不足]
10
+
11
+ **痛点:**
12
+ - [痛点1]
13
+ - [痛点2]
14
+ - [痛点3]
15
+
16
+ ## **二、功能范围**
17
+
18
+ ### 2.1 功能支持
19
+
20
+ 1. **[功能点1]**:[描述]
21
+ 2. **[功能点2]**:[描述]
22
+ 3. **[功能点3]**:[描述]
23
+
24
+ ### 2.2 涉及角色
25
+
26
+ | 角色 | 权限1 | 权限2 | 权限3 |
27
+ |---|---|---|---|
28
+ | 管理员 | ✅ | ✅ | ✅ |
29
+ | 成员 | - | ✅ | ✅ |
30
+
31
+ ### 2.3 范围内/外
32
+
33
+ **范围内:**
34
+ - [明确包含的功能]
35
+
36
+ **范围外:**
37
+ - [明确不包含的功能]
38
+ - [未来考虑的功能]
39
+
40
+ ## **三、业务流程**
41
+
42
+ [用流程图或文字描述业务流程]
43
+
44
+ ### 关键业务流程:
45
+ 1. [步骤1]
46
+ 2. [步骤2]
47
+ 3. [步骤3]
48
+
49
+ ## **四、需求详情**
50
+
51
+ ### 4.1 [功能模块1]
52
+
53
+ **位置:** [界面位置]
54
+ **权限:** [需要的权限]
55
+
56
+ **交互描述:**
57
+ - [交互细节1]
58
+ - [交互细节2]
59
+
60
+ ### 4.2 [功能模块2]
61
+
62
+ **位置:** [界面位置]
63
+ **权限:** [需要的权限]
64
+
65
+ **交互描述:**
66
+ - [交互细节1]
67
+ - [交互细节2]
68
+
69
+ ### 4.3 状态定义
70
+
71
+ | 状态 | 说明 | 可操作 |
72
+ |---|---|---|
73
+ | 状态1 | 描述 | 操作1 |
74
+ | 状态2 | 描述 | 操作2 |
75
+
76
+ ## **五、操作流程**
77
+
78
+ ### 用户操作路径
79
+
80
+ ```
81
+ 用户进入 → [操作1] → [操作2] → [操作3] → 完成
82
+ ```
83
+
84
+ ### 异常处理
85
+
86
+ - **异常1:** [处理方式]
87
+ - **异常2:** [处理方式]
88
+
89
+ ## **六、相关需求链接**
90
+
91
+ - 相关需求:[链接]
92
+ - 设计稿:[链接]
93
+ - 接口文档:[链接]
94
+
95
+ ---
96
+
97
+ **文档版本:** v1.0
98
+ **创建日期:** [日期]
99
+ **产品负责人:** [姓名]