Imported from liyouran0820/von-neumann-dreams (
AGENTS.md). Install upstream withnpx skills add liyouran0820/von-neumann-dreams. Copyright stays with the author.
项目协作约定
本文件负责项目内的协作方式和文档边界。续写时记录持续适用的约定;临时任务、设计候选和变更经过分别写入设计文档与 log.md。
工作方式
- 全程使用中文沟通,默认环境为 Apple Silicon Mac。
- 接手时先阅读
PROJECT_INTRODUCTION.md、本文件、README.md、log.md和相关设计文档,以当前文件与 Git 状态为准。 - 当前已进入可玩原型阶段;已实现范围与验证结果以
docs/V2_DEMO_STATUS.md、docs/NATIVE_DEMO_STATUS.md、验收登记、源码和检查记录为准;旧版本由历史文档与 Git 保留。 - 区分来源内容、合并建议、已实现功能和验证结果。概念笔记中的示例不作为已批准的功能规格或已验证的数据。
- 保持来源可追溯,不修改用户 Downloads 或 Desktop 中的原始设计笔记;来源快照记录路径与校验值,开发指令以用户要求为准。
- 规范维护 Git,大体积构建产物、安装包、本地配置和临时验证文件加入
.gitignore。 - 测试结束后关闭本次启动的模拟器、临时预览及高内存应用。
Markdown 职责
| 文件 | 职责 | 续写边界 |
|---|---|---|
README.md |
入口、导航、运行方式和简短状态 | 不复制完整玩法或流水日志 |
PROJECT_INTRODUCTION.md |
背景、目标、来源、总体范围 | 详细规则进入设计方案 |
docs/FINAL_GAME_PLAN.md |
当前统一推荐规格与参赛表达 | 根据用户需求和原型证据更新,区分建议与验证结果 |
docs/DEMO_V1.md |
第一版历史实现与验证结果 | 保留版本范围,不把当前源码视为首版 |
docs/DEMO_V2.md |
第二版指令交换历史范围与检查 | 明确历史快照,不能当作当前源码状态 |
docs/MAPPING_DEMO.md |
刻轨映射历史范围与检查 | 明确对应历史快照,不能当作当前源码状态 |
docs/NIGHT_WHITE_DEMO.md |
历史网页五关范围与检查 | 明确历史版本,不能转标原生通过 |
docs/LOGIC_GATES_CURRICULUM.md |
当前五关逻辑课程、知识与玩法边界及验证 | 与实际配置一致;不转标原生或真人验收 |
docs/ACADEMY_LOGIC_OPTICS.md |
历史逻辑光学试验及回溯 | 保留已知缺陷与被替代的范围 |
docs/V2_DEMO_STATUS.md |
十三关网页候选、运行、反馈修复及工程验证 | 关联实际源码与证据,区分工程、独立试玩、原生和发布 |
docs/NATIVE_DEMO_STATUS.md |
当前原生阶段、运行和验证范围 | 关联实际被测提交与证据,不把未执行项算通过 |
docs/acceptance/ |
阶段预期、状态和证据摘要 | 只有PASS计入完成,保留失败与修复历史 |
docs/requirements_gap_analysis.md |
新要求与现场差距 | 随实际证据更新可复用、迁移和外部条件 |
docs/sources/ |
来源文档完整快照与出处 | 不改来源原文;新版本另存并记录校验值 |
THIRD_PARTY_NOTICES.md |
第三方素材来源与许可 | 按实际使用维护,分发产物保留所需许可 |
docs/NIGHT_SCHOOL_PROTOCOL_DESIGN.md |
合并玩法、候选规则、原型与验证目标 | 保持草案状态,明确新增建议与待验证项 |
docs/MECHANIC_EXPLORATION.md |
核心机制候选、后果、边界与淘汰依据 | 先验证机制,再将结果写回完整设计与关卡 |
AGENTS.md |
持续适用的项目协作约定 | 不写一次性任务或未经用户确定的产品需求 |
log.md |
已发生的修改、检查和状态变化 | 追加事实,不把计划写成完成结果 |
后续前端与素材
- 按用户要求优先参考可用的
ui-ux-pro-max与frontend-design技能;未找到时说明实际可用情况并采用适合任务的设计方法。 - 界面图标统一使用 Lucide;角色、建筑、美术素材和世界设定保持原创。
- 视觉表现服务于路径辨识、机关状态和调试,不牺牲可读性、响应式与可访问性。
