用途：Wizard 用于把需要人工逐步操作、且反复向 AI 解释很麻烦的手动流程，做成一个交互式 bash 脚本。典型场景包括第三方服务配置、一次性迁移、项目从 A 状态到 B 状态的转换。脚本会打开每个 URL，说明点击和复制什么，捕获值，写入 .env 或 GitHub secrets，并在每个阶段确认、显示剩余进度。
主要能力：底层 UX 由 template.sh 解决，包括带剩余时间的进度、确认门、跨平台打开 URL（含 WSL）、隐藏密钥输入、幂等的 .env 写入、gh secret/gh variable 写入以及结束摘要。用户只需界定流程并编写各阶段。STAGES 标记以上的库在每个向导中相同，不应手动修改。向导默认是临时的，完成即删；只有需要可重复的仓库内配置路径时才提交。
使用方式：先界定流程，阅读仓库中的 .env、.env.example、README、docker-compose、框架配置和 .github/workflows 等，列出有序阶段及每个阶段产出的值，并确认。再为每个阶段写出精确路径，如“Dashboard → Developers → API keys → Reveal test key → copy”。然后复制 template.sh 到目标路径，用 stage、say/step、open_url、ask/ask_secret、write_env、set_secret/set_var、pause/confirm 等辅助函数编写各阶段，设置 TOTAL_STAGES 和 TOTAL_MINUTES。最后用 bash -n 检查，可用时运行 shellcheck，chmod +x，静态追踪而非端到端运行，并告知用户如何运行。
限制：不要自行端到端运行，因为它会打开浏览器并阻塞等待人工输入。不知道当前 UI 或确切命令时应询问用户或查文档，不要编造步骤。不要修改 STAGES 标记以上的库。每个阶段应聚焦一个任务，并在不可逆操作前确认。