📊 项目数据展示
先直接上代码体量数据:
Markdown 行数 2.38万行,整体代码行数 5.9万行。 全程 SDD 模式 规格驱动开发,效率拉满😎
🎮 游戏体验入口
TapTap 游玩二维码
上线仅一天:308次游玩 + 4条好评,论坛、游戏群收获大量玩家反馈与交流,欢迎大家体验试玩。
项目 GitHub
github.com/odbaba/moyu 欢迎围观、体验,顺手点个 Star 支持~
📝 项目介绍
此前完全没有 React 项目开发经验,利用一个多月下班碎片时间,全程借助 AI 编写 React 代码,完整复刻 魔域v1.03 全部玩法,独立完成一款全新文字版魔域小游戏。
🛠️ 开发工具
Trae 内置多款免费大模型,上手简单、生成质量高。 熟练使用后,AI 代码接纳率稳定在 95%+,后期直接关闭变更审查,节省大量无效操作时间。
🤖 模型选型
- 免费模型:GLM-5、GLM5.1、Doubao-seed-2.0、MiniMax2.7
- 付费模型:Deepseek 4 Pro(自费订阅)
- 使用策略:
- 简单业务:MiniMax2.7,轻量高效
- 复杂逻辑/大型模块:GLM5.1,稳定可靠
🚀 整体开发流程
全程使用 Trae Solo 模式: 空白文件夹起步,由 AI 初始化 React 项目,确定游戏名称与核心目标后,分模块迭代开发:
- 主页:标题区、局部地图区、交互按钮区、交互日志区
- 基础系统:菜单、大地图
- 核心玩法:角色、装备、背包、幻兽、NPC、怪物(战利品和物品模块联动)、抽奖(和物品模块联动)、日常任务(和物品模块联动)、幻兽幻化(和幻兽模块联动)、装备精炼......等等
AI 擅长单一模块独立开发,但跨模块联动必须提前规划约束。 本次踩坑:前期未统一物品、装备通用规范,导致角色装备、背包装备两套逻辑被独立编写,后期需要额外兼容改造。
大型需求统一使用 /spec 模式:
- 让 Agent 阅读现有代码,梳理我给出的需求功能,会自动输出标准化规格文档
- 依据文档逐个task开发
- 文档有误即时对话让他修改即可
关键避坑:Trae 存在已知 Bug,修改规格文档后,必须手动指令 AI 按新版文档执行,否则会继续沿用旧文档开发。
🔍 Agent 开发原理
详细原理讲解,参考我的掘金文章: juejin.cn/post/763361…
💡 AI 编程实战经验
-
合理拆分模块 AI 上下文有限,适合独立模块功能的开发。复杂功能提前拆解,定义好模块依赖与数据结构,避免完全割裂。比如角色,背包,装备三个模块分别独立,但又各自相互关联。
-
配套规格文档 每个模块维护专属规格文档,新增功能时提示词指定文档+代码路径,让 AI 精准找到修改位置。
-
精准描述问题 报错与优化不要只说“有问题”,写明:现状问题 + 期望效果,大幅降低 AI 改错成本。
-
强制代码复用 AI 容易重复造轮子,提前抽离公共工具类、组件,在规则文件中约束优先复用现有代码。
-
高效输入方式 手动写长文本提示词太过耗费时间,使用搜狗输入法语音输入,大幅提升效率。这点真的提升效率非常明显!!
-
及时接入 Lint Lint规避无效变量、冗余函数,防止长期迭代后代码腐化、维护成本飙升。AI可能会修改未使用的函数。
-
同步维护文档 定期清理过期文档,保证文档、需求统一。防止落后的文档影响Agent开发
-
完善项目规则 持续迭代
AGENTS.md全局规则,约束AI强制注释,强制更新补充文档。
📌 项目全局规则配置
项目强制要求代码添加中文注释,核心原因: AI 检索代码依赖中文语义匹配,完善注释可以极大提升代码检索、理解、迭代效率。
个人看法: 当下 AI 编程还未完全适配中文生态,如果编程语言原生支持中文变量、中文命名,结合中文提示词,AI 落地开发的效率还会迎来一次大幅升级。