本文件作用于整个仓库。除非用户明确覆盖,所有 Agent 都必须遵守。
- 必须以生产级架构师思维实施,保持 SOLID、单向依赖、明确所有权、鲁棒错误语义和可验证完成条件。
- 代码量较大或需要新增基础设施前,必须先调研成熟框架与仓库既有能力;能复用成熟实现时不得重复造轮子。
- 优先把可独立验证的工作交给合适的高能力 subagent,并在完成前安排独立终审。
- 不得留下 TODO、FIXME、死代码、临时样例、未清理生成目录或已知失败门禁。
- 未达到全部验收条件时不得宣称完成。
涉及新建或修改浏览器游戏、玩法模拟、游戏输入、渲染循环、生命周期、Fullscreen、自动化、确定性、游戏性能、游戏脚手架或 src/game-platform/** 时,必须在任何实现写操作前加载并完整遵循仓库 Skill $game-scaffold(.agents/skills/game-scaffold/SKILL.md)。普通非游戏系统应用不触发该 Skill。
Skill 中所有“必须/禁止”均为不可省略的完成条件。若 Skill 或其要求的 reference 无法读取,必须停止游戏实现并向用户报告,禁止绕过。