末日余生:极限生存 需求
使用此技能为《末日余生:极限生存》项目生成可靠的功能性需求。输出必须能帮助两类读者:
- Codex / 开发者读者:获得足够详细的细节,以便在新的窗口中继续实施。
- 项目所有者(人类)读者:获得清晰、通俗的需求描述,便于审阅和更正。
此技能仅生成功能性需求。请勿包含排期、开发周期、日期、冲刺计划、发布预测、人员安排或预算估算。
不可妥协的质量标准
不要生成一份简单的功能列表。每项核心功能必须详细展开,以支持实施和审阅。面向 AI 的需求,每项功能应包含:
- 稳定的需求 ID。
- 模块和功能名称。
- 面向所有者的一行解释。
- 目的和用户故事。
- 前置条件。
- 主流程。
- 分支/异常流程。
- 规则和边界。
- 状态/数据字段。
- 配置字段。
- UI/反馈元素。
- 错误处理。
- 双版本实现拆分:
- 共享逻辑,
- Game Studio / Phaser 主版本,
- 微信小游戏适配版本。
- 验收标准。
- 测试建议。
- 明确的非目标。
- 待定问题。
面向读者友好的需求,每项功能应解释:
- 此功能做什么。
- 玩家如何使用它。
- 正常操作是什么样的。
- 什么可能出错。
- 必须遵守哪些规则。
- 玩家能看到什么。
- 什么算完成。
- 暂不包含什么。
- 项目所有者需要确认什么。
如果输出感觉比项目开发计划更短或更简略,请在交付前丰富内容。
核心项目策略
除非用户明确更改,否则始终遵循此策略:
- 首先在 Game Studio + Phaser/TypeScript 浏览器主版本中构建游戏玩法。
- 将稳定的功能转换或迁移到单独的微信小游戏适配版本中。
- 保持两个代码版本:
Game Studio / Phaser 主版本:快速游戏玩法迭代、浏览器试玩测试、调试、功能验证。微信小游戏适配:微信运行时桥接、触摸/生命周期/资源/登录/适配、模拟器和真机验证、发布。
- 不要让微信特定的运行时工作污染与平台无关的游戏逻辑。
标准输出
当用户要求为此项目生成需求时,创建一个或两个以下文件:
ai-functional-requirements.md:面向实施、精确、结构化,适合 Codex 交接。reader-functional-requirements.md:人类可读、纯中文,重点关注玩家所见以及项目所有者可以批准的内容。
如果用户要求 Word 文档,则使用文档技能从相同内容创建 .docx 版本。
工作流程
- 首先检查可用的项目产物:
deliverables/中的现有 PRD/文档;- 当前的 Game Studio/Phaser 源代码;
- 当前的微信小游戏源代码;
- 问题/解决方案日志(如果存在)。
- 仅提取功能性需求和项目约束。忽略排期和日期。
- 在编写正文之前,先构建功能清单。
- 首先生成面向 AI 的规格文档。
- 从相同需求清单生成面向读者的友好文档。
- 验证这一对文档:
- 不包含排期/时间线语言;
- 两个文档描述相同的功能集;
- 明确说明双版本策略;
- 每项核心功能都包含规则、流程、错误、数据/配置、验收标准和待定问题;
- 待定问题需明确标记,而不是猜测。
需求 ID 约定
使用稳定的 ID,以便后续的文档、代码、测试和问题可以引用相同功能:
ES-FR-META-*:项目边界和跨版本规则。ES-FR-CORE-*:核心循环、匹配流程、结算。ES-FR-PLAYER-*:玩家移动、控制、交互、状态、死亡、复活。ES-FR-MAP-*:地图、摄像机、碰撞、安全区域、兴趣点。ES-FR-ZOMBIE-*:敌人/僵尸生成、AI、战斗。ES-FR-SURVIVAL-*:生命值、饥饿、口渴、耐力、感染。ES-FR-ITEM-*:战利品、背包、拾取、丢弃、使用。ES-FR-CRAFT-*:合成。ES-FR-BUILD-*:建造和放置。ES-FR-COMBAT-*:武器、攻击、命中检测、伤害、反馈。ES-FR-NET-*:匹配、房间、同步、重连。ES-FR-WECHAT-*:微信登录、生命周期、资源、广告、排行榜、合规。ES-FR-UI-*:HUD、菜单、提示、结果。ES-FR-DATA-*:保存、配置、遥测、后端记录。ES-NFR-*:非功能性需求,例如性能、兼容性、安全性、可维护性。
辅助脚本
使用 scripts/generate_requirements.py 生成详细的 Markdown 文档对。建议从项目根目录运行,并传递 --project-root . 参数,以免非 ASCII Windows 路径被 shell 编码破坏:
python extreme-survival-requirements/scripts/generate_requirements.py --project-root . --out-dir deliverables/requirements
该脚本包含一个排期术语保护机制,如果检测到常见的排期类术语将失败。
请勿包含
- 开发周期、周计划、日期、发布预测或人员估算。
- 收入保证或平台批准保证。
- 隐藏的思维链、私有凭据、AppSecret、令牌或个人标识符。
- 与双版本 Game Studio → 微信小游戏策略相矛盾的需求,除非用户明确更改方向。