可复制的 AI 需求与排错模板
复制后替换方括号中的内容。不要把私人凭据、完整用户数据或生产 AppSecret 粘贴给 AI。
模板一：新增一个功能
环境：Cocos Creator 3.8.8，TypeScript，2D 微信小游戏。
当前功能与节点树：[粘贴相关部分，不是整个项目]
目标：玩家[操作]后，系统[规则变化]，画面[反馈]。
规则：仅在[状态]可操作；重复操作按[规则]处理。
数据：[字段与来源]；关键奖励由服务端确认。
异常：取消、超时、缺资源、切后台、退出场景时分别[行为]。
资源：[已有素材、尺寸、路径]。
验收：[至少一个正常场景和两个边界场景]。
请先给节点树、状态图、组件职责和需手动配置的字段。
方案确认后再写完整脚本，标注新增与修改文件，给验证步骤。
模板二：要求编辑器装配步骤
我有下面的脚本：[粘贴脚本或文件]
请按 Creator 3.8.8 说明：
1. 创建哪些节点，各自的父节点、组件、尺寸和锚点是什么。
2. 脚本挂在哪里，检查器每个字段拖入哪个组件。
3. 哪些事件由代码绑定，哪些由检查器绑定，避免重复。
4. 资源放到什么目录，如何确认导入成功。
5. 预览后应看到什么，最先检查哪些日志。
不确定的设置请明确说明，不假造编辑器按钮名称。
模板三：异步加载与资源管理
需求：[例如进入关卡加载一个背景 SpriteFrame]
资源：[实际目录与文件名]，加载方式：[静态引用/resources/Bundle]
请实现 loading/ready/error 状态与手动重试。
重复重试时旧结果不得覆盖新结果；退出页面后不得改旧节点。
说明资源所有者、引用持有与释放时机，不释放共享全局资源。
给出路径错误、网络失败、切场景后返回三类测试。
模板四：微信平台接入
目标能力：[登录/激励视频/关系链榜]，目标是微信小游戏。
浏览器预览只能显示明确标注的模拟结果。
请列出账号、AppID、域名、广告位或开放数据域等前提。
平台 API 与我的业务代码分离，错误恢复与重复回调规则明确。
客户端不含 AppSecret，不打印 code/token。
列出必须真机验证的项目，并引用官方来源与基础库条件。
无法核实的条件请标为待验证，不自行编造额度或政策。
模板五：诊断一个故障
环境：[引擎、构建、设备、微信客户端/基础库信息]
预期：[具体结果]
实际：[具体结果与出现频率]
最短步骤：[按顺序列出]
证据：[相关节点树、脚本、首次错误日志、提交号]
请先提出按可能性排序的根因，每个给验证办法。
确认后做最小修复，解释它为什么解决根因。
给出原问题和相邻边界的回归步骤，不用延迟或吞错掩盖问题。
模板六：检查 AI 生成的代码
请审查下面的 Creator 3.8.8 TypeScript 代码：
关注版本/API、组件挂载、事件解绑、计时、Tween停止、异步过期结果、
资源所有权、输入状态和服务端可信边界。
只指出有证据的问题，给触发场景与实际后果。
区分静态可确认问题与需要编辑器/微信真机才能验证的问题。
暂不重构与当前功能无关的部分。
使用模板后保留一份最新功能规格；代码变了，规格、图和验收也要更新。