xiaochoupai/AGENTS.md

项目规则

目标与工作边界

• 开发基于 Web 的小丑牌式单人构筑游戏，以规则正确、完整对局和复古牌桌表现为优先级。
• 用户已授权实施；实施范围以 docs/implementation-plan.md 为依据，实际首版规则以 docs/rules.md 为准。
• 附图仅作为视觉参考；图中局内数值不能直接作为默认规则。
• 已核实规则、社区资料和本项目设计选择应明确区分；不声明尚未验证的原作一致性。

目录约定

• 根目录：项目规范、README、依赖和构建配置。
• docs/：方案、规则研究、验收记录；Markdown 文件用小写短横线命名。
• src/core/：纯 TypeScript 规则、状态、随机数与结算，不依赖 DOM、渲染引擎或音频。
• src/content/：带稳定 ID 的牌型、小丑、盲注、消耗品等内容定义。
• src/app/：用户命令、状态流转、存档及表现层协调。
• src/render/：牌桌、卡牌、动效、着色器、输入命中；只能消费核心状态与事件。
• src/platform/：浏览器存储、音频、窗口和生命周期适配。
• public/assets/：运行时美术、字体、音频；来源与许可记录在 docs/assets.md，素材导入前建立该文件。
• tests/：规则测试、组合用例、对局与浏览器验收；禁止用生产实现自身生成唯一预期结果。
• artifacts/：可复查的截图和验收输出；临时文件使用系统临时目录，阶段结束清理无用输出。
• 不提前创建空目录；新增职责或改变边界先修改此文档。若后续增加 CLAUDE.md，须与此规范保持一致。

实现约束

• 所有 shell 命令遵守 /Users/richard/.codex/RTK.md，通过 rtk 或 rtk proxy 执行。
• 计分由核心引擎一次确定并输出事件序列；动画不负责修改得分或发放奖励。
• 随机数可设种子、可保存状态；商店、抽牌和效果使用独立随机流。
• 实例 ID 与内容 ID 分离；允许重复点数、花色和重复内容实例。
• 禁止把小丑效果、Boss 规则写进卡牌绘制或点击处理函数。
• 使用自制或可使用的素材；截图不能充当交互界面或直接拆作牌面资源。
• 先做规则和完整流程的针对性验证，再验证画面、触屏、性能与兼容性；如实记录未验证平台。