用途：wizard 用于把一个需要人工逐步操作、且反复向 AI 解释很麻烦的手动流程，做成交互式 bash 脚本。典型场景包括第三方服务配置、一次性迁移，以及项目从状态 A 到状态 B 的转换。
主要能力：向导会依次打开每个 URL，明确告诉人点什么、复制什么，收集输入值，并写入应在的位置（.env、GitHub secrets），每个阶段都要求确认，并显示剩余步骤和剩余时间。模板 template.sh 已解决交互体验：带剩余时间的进度、确认门、跨平台打开 URL（含 WSL）、隐藏式密钥输入、幂等的 .env 写入、gh secret/gh variable 写入，以及收尾总结。
使用方式：先界定流程，读仓库中的 .env、.env.example、README、docker-compose、框架配置和 .github/workflows/，找出每个 secrets. / vars.* 需要产出的值；确认按顺序排列的阶段及各阶段产出的值。再为每个阶段映射人的具体路径，例如“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，再把运行方法告诉用户。
限制：wizard 默认是一次性的，只跑一次，可放在 scratch 或 scripts/ 路径，用完删除；只有用户想要可重复的仓库内配置路径时才提交。不要端到端自行运行，因为它会打开浏览器并等待人工输入。不要手动修改模板中 STAGES 标记以上的库代码。未知的当前 UI 或精确命令应询问用户或查文档，不得编造。资料未提供具体命令示例和模板完整内容。