这个案例以“认识整点”为例，演示如何把本地 AI 工具与伴学连接起来。你负责教学目标和验收，Agent 负责实现，learn-cli 负责与平台衔接。
先安装，再登录
在 learn-cli 下载页按页面指引安装工具。终端输入下面的命令，确认安装完成：
learn-cli --help
learn-cli login
浏览器会打开伴学授权页面。只批准你自己在终端发起的设备请求。登录凭据由 CLI 保存，不要复制进课程代码或发给他人。新版会在授权完成后自动安装伴学创作技能；新建 AI 会话后，就可以直接说“用伴学制作一节认识整点的互动课”。
如果正在调试本地伴学平台，需要显式连接本地服务：
learn-cli login --server http://localhost:3000
把需求交给 Agent
进入课程工作区，在 Codex、Claude Code 或 OpenCode 中表达你的目标。例如：
请按照工作区的 LEARN-CLI.md，为 4～6 岁儿童制作“认识整点”。使用真正的可交互钟面；时针短、分针长；整点时分针指向 12。安排观察、拨针和 4 道迁移练习。答错时给提示，也允许继续。请完成校验并启动本地预览，等我确认后再同步草稿。
你不需要先创建目录或执行 setup：Agent 会准备课程工作区、读取规范并安装预览依赖。已有课程也由 Agent 帮你取回。老版本用户安装新版后执行一次 learn-cli agents install 补装技能，无需重新登录。下面的校验、预览和同步命令都可以交给 Agent 执行。
在本地核对“看起来对”与“实际正确”
learn-cli validate
learn-cli preview
时钟的关键不是颜色，而是坐标与判题的一致性。检查 12、3、6、9 四个方向，再检查 7 点等斜向位置。特意尝试错误选项，确认反馈合理且不会阻塞继续学习。
如果使用可复用教学组件，应遵循平台组件契约；自由画面也必须经过同样的交互验收，不能凭一张截图就判断完成。
配音也要在真实链路中试听
通过 learn-cli preview 启动后，预览器会优先播放课程已有音频。缺少的音频通过已登录的 CLI 请求平台自然配音，并缓存在 course.audio.json。
已有缓存可离线播放；没登录、没网络或配音服务不可用时，应看到明确提示。不要为了“能出声音”改成浏览器系统朗读，这会让本地与平台音色不一致。
旧创作包可先升级预览器：
learn-cli setup --upgrade-preview
确认后同步，发布前再检查
learn-cli sync --confirm
同步保存的是平台草稿，不等于公开发布。回到网页确认课程内容和发布范围，再完成发布流程。
这个工作流同样适用于英语对话、摄影入门、生活技能等主题。先让一节小课可靠地工作，再逐步扩展。