5.1 KiB
5.1 KiB
todos:
- id: "user-input" content: "用户下一条消息提供：变更一句话、涉及仓库、原因、数据影响、优先级" status: pending
- id: "draft-prd" content: "按 docs/requirements 体例撰写变更 PRD（含变更前后对比表与验收标准）" status: pending
- id: "index-link" content: "若属已有需求体系，更新 README/父文档索引并链到新文档" status: pending
- id: "user-review" content: "根据用户反馈修订开放问题与验收项" status: pending isProject: false
协作撰写变更需求 PRD
可以做什么
可以帮你写变更需求（Change Request）PRD，结构对齐你仓库里已有规范，例如：
- 父文档：docs/requirements/game_gateway_risk_prd_v_2.md
- 子需求：docs/requirements/game_gateway/01_launch_session.md
这些文档已包含：目标与范围（In/Out scope）、依赖与边界、业务流程、数据表/接口、验收标准——与你选择的「标准 PRD」一致。
当前阻塞：需要你补充变更说明
你已选择：其它主题 + 变更需求 + 下一条消息文字说明。在 Plan 模式下还缺少以下最小信息（建议下一条回复用 5～10 行写完）：
| 必填 | 示例 |
|---|---|
| 变更一句话 | 「渠道创建时编号由运营手填改为系统生成」 |
| 涉及系统/仓库 | slot-admin、slot-admin-vue、slot_wallet 等 |
| 变更原因 | 运营误填、编号冲突、对接要求 |
| 是否影响线上数据 | 仅新数据 / 需迁移历史 |
| 期望上线时间或优先级 | P0 / 本迭代 / 可排期 |
可选但有助于写准：
- 相关页面或接口路径
- 已知约束（不能改表、必须兼容某厂商等）
- 是否需挂到现有父文档（如 Game Gateway 系列）
变更需求 PRD 文档结构（将按此产出）
在标准 PRD 基础上，变更类会额外突出「前后差异」，建议章节如下：
flowchart TB
input[你提供的变更说明]
code[可选：对照现有代码/表结构]
draft[撰写 PRD 初稿]
review[你确认/修订]
output[Markdown 落库或对话交付]
input --> code
code --> draft
draft --> review
review --> output
1. 文档元信息
- 标题、版本（如 V1.1-change）、日期、作者/评审人
- 关联父文档（若属于 Game Gateway 等已有体系）
2. 背景与变更动机
- 现状问题（As-Is）
- 变更目标（To-Be）
- 不做的范围（Out of scope）
3. 变更摘要（核心）
| 维度 | 变更前 | 变更后 |
|---|---|---|
| 业务规则 | … | … |
| 界面/交互 | … | … |
| 接口/字段 | … | … |
| 数据/缓存 | … | … |
4. 功能需求（按角色或模块）
- 管理端 / 用户端 / innerapi / 跨服务（slot_sdk）分项
- 每条需求：描述 + 规则 + 异常/边界
5. 接口与数据（如涉及）
- API 路径、请求/响应字段变更（新增/废弃/只读）
- 表字段、索引、Redis key、MQ（若有）
- 幂等、事务、兼容性说明
6. 非功能需求
- 性能、安全、日志、监控、回滚策略
7. 验收标准（可测试）
- Given / When / Then 或检查清单
- 回归范围（哪些旧功能不能坏）
8. 实施与发布建议（可选）
- 涉及仓库与大致文件（实施阶段再细化）
- 发布顺序、配置开关、数据迁移步骤
9. 风险与开放问题
- 待产品/技术确认项列表
撰写时我会怎么做（确认计划后执行）
- 读你提供的变更说明，必要时只读检索相关代码（Controller / Logic / Model / Vue），保证 PRD 与实现或意图一致。
- 对齐仓库体例：表格元信息、In/Out scope、mermaid/文本流程图，与 01_launch_session.md 风格一致。
- 落盘位置（默认，你可改）：
- 独立变更：
docs/requirements/<模块>/<简短英文名>_change.md - 若属 Game Gateway 体系：在 game_gateway/README.md 索引中增加一行，并链到父文档
- 独立变更：
- 交付方式：默认写入仓库；若你只希望对话里预览，说明「不要写文件」即可。
不会在未经你确认前修改业务代码；Plan 阶段仅产出文档。
与「反推 PRD」的区别
你选的是变更需求，不是从零或纯反推。若变更其实已部分落地（例如 GameServerLogic.php 里渠道编号自动生成），可在 PRD 中标注 「已实现 / 待实现」，便于评审与补测。
你确认计划后的下一步
请在下一条消息直接粘贴变更说明（不必等再点选）。收到后我将：
- 定文档标题与存放路径
- 输出完整 PRD 初稿（Markdown）
- 请你审阅「开放问题」与验收项，再按需修订一版
若变更属于 Game Gateway / 渠道 / 钱包等已有域，请点名，我会自动挂接对应父文档索引。