任务拆解、上下文与持续协作
让 AI 一次实现大量耦合功能,常见结果是代码很多,但每个系统都只接了一半。拆解的目标是让每步都有能运行的行为,并且失败后能够定位。完整产品范围可以很大,单次实现与验证应有明确边界。
按可玩的纵向行为切片
“先完成所有数据层,再完成所有UI”容易积累长时间无法运行的代码。可以先打通一个行为:按钮接受输入、规则执行一次攻击、目标受伤、HUD更新。它的美术可以简单,但状态链路应完整。再扩展敌人类型、技能和反馈。
| 切片 | 输入到结果 | 本轮证据 |
|---|---|---|
| 移动 | 接受方向 → 归一化 → 按秒更新位置 → 绘制 | 不同帧率距离相近、对角不加速 |
| 攻击 | 输入 → 时序状态 → 范围判定 → 扣血 | 同次攻击命中去重、暂停冻结 |
| 波次 | 生成 → 追击 → 清空 → 下一波 | 每波只生成一次、第三波后结算 |
| 存档 | 结算 → 更新记录 → 持久化 → 重启读取 | 写入失败不阻塞局内、坏数据有回退 |
| 平台 | 构建 → 工具运行 → 真机检查 | 每个环境保留独立记录 |
切片之间仍有依赖。没有正确的角色状态,动画事件可能在死后继续攻击;没有明确的奖励事务,结算UI会掩盖重复发奖。先写依赖图,按最早能够消除风险的顺序安排。
一份任务单只承诺一组可验收行为
任务:让敌人追击并在接触时造成伤害。
依赖:角色位置、playing/paused状态已存在。
文件入口:assets/scripts/rules.ts、Arena.ts。
规则:按秒运动;接触距离34;受击后0.8秒无敌;HP不能反复结算到负值。
范围:加入规则与当前几何表现,不改波次数值与存档格式。
需要交付:改动说明、规则测试、操作复现步骤。
边界:暂停、角色死亡、场景销毁、同帧多个敌人接触。
输入应包含任务所需的真实文件,而不是整个仓库所有内容。过大的上下文会让重要约束难以定位;过小则会让 AI 重建已有能力。模块入口、接口契约、关键调用者、现有测试和具体报错,通常比大量历史对话更有价值。
维护长期有效的项目事实
把稳定约定保存在项目文档中:引擎版本、构建命令、目录职责、数据单位、平台目标、素材来源、验证入口。把本轮临时实验参数与未解决问题写进任务记录。把最终产品规则写在规格文档,而不是只留在聊天中。
文件应解释“在哪里查、何时适用、怎样验证”。例如“改动共享规则后,执行规则测试并重建Cocos目标”比“代码要高质量”更能帮助下一轮协作。验证记录要附源码版本,避免把旧产物误认成当前代码。
并行工作怎样划清边界
素材调研、互不冲突的专题文档、独立规则分析适合并行。多个任务同时修改场景入口、全局状态或构建配置,容易产生语义冲突。并行前明确每项任务可写的路径、共同的数据契约以及最终集成者。
并行完成不等于集成完成。需要验证接口是否一致、相对路径是否正确、状态是否只维护一份、依赖是否被重复添加,以及每项结果是否进入真正的可运行入口。以最终构建的行为判断,不能只依据每个任务的完成报告。
当上下文中断时怎样恢复
让 AI 先读工程约定、当前差异与验证记录,再继续任务。恢复摘要至少包含目标、已确认规则、当前文件状态、通过的检查、未解决错误和下一步。把“已经尝试过但失败”的方案与证据写下来,可以避免循环试错。
请先恢复上下文:读取AGENTS.md、当前git diff、相关规则与验证记录。
复述目前已经实现的行为、真实通过的检查和仍未解决的问题。
保留既定规格与用户已有修改,从最早未通过的验收场景继续。
如果源码与构建产物时间不一致,先重建再做浏览器判断。
检查任务拆解质量的办法是:任取一步停止开发,是否仍有可演示、可解释、可回归的行为。若只有大量类和接口,说明切片尚未贯通。
来源与边界
协作与切片建议是本手册的方法总结。核查日期:2026-11-17。