game-dev-skills 实战用例

game-dev-skills 是游戏功能研发总入口，按阶段协调 game-designer、ui-designer、client-dev、server-dev、game-qa，并通过门禁推进交付。

授权说明：技能管理相关能力需 Team 授权。

适用前提

• 已配置项目目录和技术栈（客户端、服务端、策划、UI）
• 已明确当前功能边界和验收目标
• 缺失 PRD/FRD 时先走需求结构化，不直接编码

用例 1：限时活动系统（活动副本 + 奖励结算）

输入：策划给出 Word 版活动需求文档。
执行：

• 阶段 1：解析文档并产出 feature-prd.md、配置表草案
• 阶段 2：拆分 UI 面板、客户端状态机、服务端结算逻辑
• 阶段 3：按活动开启/结束边界做联调与回归

交付：

• feature-prd.md
• config-schema.md
• ui-binding.md
• integration-report.md

用例 2：战斗技能重做（伤害公式与表现同步）

输入：已有旧技能系统，需要替换伤害公式和表现流程。
执行：

• 策划明确公式参数、触发条件、异常分支
• 客户端处理表现与状态同步，服务端保留权威判定
• QA 做 P0 战斗路径和错误码校验

关键检查：

• 客户端不持有最终判定
• 数值规则配置化，无魔法数字散落

用例 3：商城支付链路（商品、订单、到账）

输入：新增内购商品与首充礼包。
执行：

• 策划定义商品配置字段和状态流转
• 服务端实现订单校验、幂等、防重放
• 客户端处理支付回调与到账展示
• QA 覆盖成功/失败/重试/超时场景

交付重点：

• 错误码和状态机一致性
• 对账与补单路径可追踪

用例 4：UI 改版（背包与养成面板）

输入：已有功能不变，仅改 UI 结构和交互。
执行：

• ui-designer 输出结构、命名、绑定契约
• client-dev 完成绑定和事件处理
• game-qa 覆盖多分辨率和交互回归

收益：

• UI 资源命名、绑定路径、事件流统一
• 降低后续功能迭代的返工率

用例 5：跨端联调（客户端 + 服务端 + 配置）

输入：新功能代码已完成，联调阶段频繁出现协议不一致。
执行：

• 校验 proto 版本与配置版本
• 对齐请求/响应字段和默认值策略
• QA 做三端耦合测试与证据记录

输出：

• qa-cases.md
• integration-report.md
• 可追溯的 Open Issues 清单

推荐落地方式

1. 先从单一功能线试点（如活动系统或商城）
2. 用固定模板沉淀交付物（PRD/绑定文档/联调报告）
3. 每次迭代都过 Design / Implementation / Integration / QA 四道门禁
4. 逐步扩展到完整版本迭代链路