跳到主要内容

把功能需求写成可执行的游戏规格

“加个闪避”“角色有打击感”“做成某游戏那样”可以开启讨论,却不足以指导实现。功能规格需要说明:谁在什么状态下,接收什么输入,经过哪些规则,产生什么结果,以及怎样证明行为正确。你不必先知道全部实现 API,但需要把产品决策与技术问题分开。

用六个维度描述功能​

维度需要写清的内容闪避功能示例
触发输入、前置条件、优先级点击闪避;存活且冷却结束;攻击后摇是否允许取消
状态进入、持续、退出Idle/Move → Dodge → Idle;死亡可以打断
时间单位、计时源、暂停关系持续 0.25 秒,冷却 1 秒,暂停冻结
空间方向、距离、坐标与碰撞世界坐标沿移动方向,停止时沿朝向,不能穿墙
反馈画面、声音、UI残影、短音效、冷却扇形、无敌阶段颜色变化
证据正常、边界、异常验收贴墙不会穿出;连续点击只触发一次;切后台不瞬移

示例参数是教学决策,不是通用最佳值。重要的是参数有单位,状态有边界,每个可变行为有明确负责人。

先写规则,再选择实现​

“闪避使用 Tween”已经在替实现做决定,但未说明碰撞如何处理。Tween 适合属性插值,并不自动保证沿途物理检测。你可以先写“以 600 世界单位/秒沿方向运动,使用逐步碰撞约束”,让 AI 分析该需求应该由运动控制器、物理速度还是其他方式承担。

数据也需要契约。比如无敌时间到底是动画事件定义的窗口,还是独立规则配置;冷却从输入接受时开始,还是动作结束时开始;速度加成是否影响闪避。这些决定会影响动画、UI 和战斗结算,不能留给不同组件各自猜测。

type DodgeSpec = {
durationSeconds: number;
speedWorldUnitsPerSecond: number;
cooldownSeconds: number;
invulnerableStartSeconds: number;
invulnerableEndSeconds: number;
canCancelAttackRecovery: boolean;
};

对时间和并发进行演算​

游戏中的并发不只来自线程。事件回调、下一帧更新、动画事件、网络响应与资源加载完成,都可能在不同时间作用于同一对象。写出“第 0 秒输入、第 0.1 秒受击、第 0.15 秒死亡、第 0.2 秒加载完成”,检查每步能否继续执行。

例如角色开始闪避后死亡,闪避结束回调若无条件切回 Idle,就会把死亡状态复活。更稳妥的方式是退出状态时取消回调,或用状态版本号检查回调是否仍属于当前动作。具体方案应与项目已有生命周期机制一致。

把验收写成行为场景​

Given:角色存活、位于墙左侧、冷却为零,朝右。
When:按下闪避,并在持续期间连续按攻击。
Then:角色沿右方向移动且停在墙外,不穿墙;
是否接受攻击由规格决定,不能随机依赖帧率;
闪避结束后恢复可操作,冷却显示与规则剩余时间一致。

异常场景:闪避中暂停、切后台、死亡、换场景、加载失败。
对照场景:30/60 FPS 下总距离相近,并记录允许误差。

验收描述里尽量使用“距离、次数、状态、时序、可见结果”,减少“流畅、自然、合理”这类无法独立判断的词。感受类目标仍然可以保留,但应配参考录像、参数范围与人工体验记录。

给 AI 的任务应该到什么颗粒度​

“实现完整闪避系统”可能同时修改输入、状态、碰撞、特效和 HUD,失败后很难定位。可以按可运行的纵向行为拆解:先让无表现的角色接受输入并按规则移动;再加入碰撞与打断;再接无敌判定;最后接反馈与冷却 UI。每步都保留能够验收的行为。

请先复述下面规格,列出冲突与缺失决策,再实现最小纵向切片。
基线:Cocos Creator 3.8.8,现有 PlayerMovement 负责位置约束。
本次目标:接受一次闪避输入,按 DodgeSpec 运动并处理墙体。
输入/输出:提供会修改的文件、公开接口与状态转换。
验证:提供可复现步骤,说明30/60 FPS、贴墙、暂停三组结果。
实现后解释每个参数单位,以及状态退出时如何清理。

完成后检查 AI 是否悄悄改变了玩法规则,是否为了完成本次任务重写了无关模块,是否把浏览器测试结果当成微信平台结论。功能规格会随真实试验修订,但每次变更都应留下原因与验收更新。

来源与适用边界​

本章的六维规格与拆解模板为本手册的工作方法。核查日期:2026-11-17。