使用指南 / 04
用 AI Agent 创造专属玩法
从一句清晰的需求开始，让 AI 编程 Agent 完成开发与构建，再把玩法安装到真实的 AI Passport。
STEP / 01
先决定它要解决什么问题
AI Passport 的小屏幕、实体按键和随身形态可以承载学习工具、小游戏、计时器、身份展示等不同体验。先选定一个真实场景，并用一句话写清楚用户拿起设备后要完成什么。
- 场景：它会在什么时候、由谁使用？
- 目标：用户完成哪个动作就算成功？
- 范围：第一版只保留一个核心体验。
STEP / 02
先体验官方玩法，确认设备可连接
用 USB 数据线连接 AI Passport，从官方玩法库选择一个已发布玩法并完成一次安装。这样可以先确认数据线、浏览器串口权限和设备连接都工作正常。
这一步不会替代开发，但能先排除线材或连接问题，给后面的自定义玩法验证留下可靠基线。
STEP / 03
定义专属玩法的最小版本
把想法收敛成可以在真实硬件上验证的第一版。明确屏幕上显示什么、三个按键分别做什么，以及是否需要声音、蓝牙、网络或本地存储。
- 界面：列出主要画面、文字和状态
- 输入：定义上键、下键和确定键的短按或长按行为
- 反馈：说明成功、失败、加载和退出时的表现
- 约束：写明屏幕尺寸、离线需求、资源大小和目标硬件
STEP / 04
选择一个 AI 编程 Agent
使用 TRAE、Codex、Claude Code 或其它可以读取项目、修改代码并运行构建命令的 AI 编程 Agent。打开玩法项目目录，让 Agent 先检查项目说明、已有示例和构建方式，再开始修改。
请下载并参考这个项目代码：
https://github.com/folotoy/ai-passport
帮我开发一个敲木鱼的应用。
不要只粘贴一段孤立代码。让 Agent 在完整项目中工作，才能复用正确的依赖、硬件配置和构建流程。
STEP / 05
把需求说清楚
把前面整理好的场景、界面、按键和约束一次性交给 Agent，并要求它先复述方案和实施步骤。信息越具体，第一版越接近可以直接上手验证的体验。
- 我要做什么，以及给谁使用
- 启动后的第一屏和完整操作流程
- 每个按键在不同状态下的行为
- 必须复用的现有代码、素材或接口
- 完成标准：构建成功并输出可安装的玩法文件
STEP / 06
让 Agent 完成开发、构建与自检
让 Agent 按计划实现功能，运行项目提供的构建命令，并根据错误继续修正。结束时请它说明改动内容、测试结果、玩法文件路径，以及仍然存在的限制。
源代码生成完不等于任务完成。至少确认构建命令成功结束，并能找到项目实际产出的玩法文件。
STEP / 07
安装玩法，在真实硬件上验证
打开本地玩法安装工具，选择 Agent 构建出的玩法文件并连接 AI Passport。核对文件与设备后开始安装；完成后重启设备，逐项检查屏幕、按键、声音和连接功能。
- 安装过程中不要拔线或关闭页面
- 第一次先使用测试设备，并保留可恢复的官方玩法
- 记录与预期不一致的画面、按键和异常日志，再交给 Agent 修正
STEP / 08
把它带进真实场景，再迭代一轮
离开电脑后再使用一次，观察文字是否清楚、单手按键是否顺畅、反馈是否及时，以及电量和连接是否符合场景。把最影响使用的问题按优先级交给 Agent，重新构建和刷写。
- 先修复阻塞核心流程的问题
- 一次迭代只改变少量可验证内容
- 为每个可用版本保留版本号、源码提交和玩法备份