从模糊想法到 AI 能执行的需求
高效协作不是一次写很长的提示词,而是让每轮工作有共同的事实、明确的决定和可观察结果。游戏需求尤其容易在“手感、时序、空间、画面”上含糊。你可以把后端接口契约的思维迁移过来,再补上时间与表现。
区分四种输入
目标解释玩家要完成什么;规则定义系统怎样决定结果;参考描述你希望接近的体验或视觉;约束规定引擎、平台、资源与交付边界。参考录像不会自动提供规则,规则表也不会自动决定动画节奏。
“做一个像某游戏的攻击”缺少攻击范围、命中次数、前后摇、打断条件和反馈时间点。更明确的表达是:角色接受输入后进入0.12秒前摇;随后0.1秒内对朝向前方100世界单位内敌人各结算一次伤害;0.22秒后摇结束才能再攻击;暂停冻结这套计时。数值只是本案例的教学规格,可以按体验改。
开发简报的最小完整结构
项目:竖屏试炼,微信小游戏,Cocos Creator 3.8.8 + TypeScript。
目标玩家行为:移动躲避追击,抓住距离攻击,完成三波敌人后结算。
本次需求:近战攻击规则与可视化,不增加成长系统。
现有事实:
- 角色位置为Canvas中心局部坐标,+x向右,+y向上。
- rules.ts负责规则;Arena.ts负责输入、绘制和平台生命周期。
- 物理碰撞与伤害检测当前使用自定义几何,不接刚体系统。
规则:
- 活着且playing时接受输入,攻击中重复输入按当前规格处理。
- 前摇0.12s、有效0.10s、后摇0.22s,单位全部为秒。
- 一次攻击对同一敌人只能结算一次;死亡立即停止主动攻击。
表现:
- 前摇显示半透明攻击范围,有效阶段提高亮度。
- 生命和波次由规则状态驱动,不在HUD另计一套数值。
验收:
- 范围外不受伤;同次攻击不重复扣血;暂停不推进时序。
- 在规则测试和Web构建中复现;微信真机另列证据。
请先复述你的理解,指出冲突和必要的缺失决策,再提出最小改动。
这份简报足以让 AI 进入具体工作,又保留了它选择实现细节的空间。如果你已经有代码,把真实路径与入口附上,避免 AI 新建一套与项目断开的演示。
让 AI 处理事实调查,让你处理产品决定
引擎 API 名称、已有组件、构建脚本、目录结构和报错来源可以调查。攻击是否允许取消、死后是否保留本轮奖励、广告中途失败如何提示,则是产品决定。要求 AI 把二者分开,并为决定给推荐方案与理由。
回答问题前,可以要求它先查当前工程。比如项目已经存在存档迁移机制,就应接入它,而不是再造一个 SaveManager。提供官方来源时核对版本,特别防止 Cocos 2.x 写法混入 3.8 项目。
用例子限定歧义
需求里至少给一个正常例子和一个反例:“目标在距离99且朝向前方,命中;距离101,不命中。”边界值不是最终玩法设计,但能揭示双方是否使用同样的距离定义。若敌人有半径,还需说明距离按中心、边缘还是形状相交计算。
视觉参考要附观察说明:“关注按钮弹起后的减速,不参考配色与图标。”如果引用整张画面,AI 可能同时改布局、字体和交互,增加验收范围。把你要保留的特征明确写出。
如何判断这一轮沟通有效
AI 开始实现前,你应能回答:它会改哪些文件;哪些规则由你决定;哪些事实已经核实;怎样运行和检验;失败时应提供什么证据。若它只能给出泛泛步骤,说明工作单还没有落到状态、数据和行为层面。
验收这份需求本身,可以找一个不了解对话历史的人照着演算一次功能。只要他还需要猜输入优先级、坐标或结算时间,就把对应决定补上。简报与实际规则一起更新,才不会让后续 AI 读到过期上下文。
参考与适用边界
上述模板是本手册的工程协作方法,不承诺任何模型自动正确。核查日期:2026-11-17。