用途：wizard 用于把那些手工做很繁琐、每次向 AI 重新解释也很繁琐的手动流程，写成可交互的 bash 向导，带人类一步步完成。典型场景是配置第三方服务、执行一次性迁移，或把项目从一个状态迁移到另一个状态。
主要能力：基于 template.sh 提供界面，包括剩余时间进度、确认关卡、跨平台打开 URL（含 WSL）、隐藏式密钥输入、幂等的 .env 写入、gh secret/gh variable 写入和结尾摘要。向导默认是临时的，一次运行用完即删；只有当用户希望仓库里有可重复的配置路径时才提交。STAGES 标记之上的库在每个向导中完全一致，不要手工编辑。
使用方式：先梳理流程，列出所有手动步骤和沿途采集的值，并读取仓库（如 .env、.env.example、README、docker-compose、框架配置、.github/workflows 中的 secrets.* 与 vars.* 引用）；再为每个阶段映射人的具体操作路径（打开哪个 URL、在哪看到值、填入哪个变量）；然后把 template.sh 复制到目标路径，按依赖顺序替换为每个步骤一个阶段，使用 stage、say/step、open_url、ask/ask_secret、write_env、set_secret/set_var、pause/confirm 等辅助函数，并设置 TOTAL_STAGES 与 TOTAL_MINUTES。
验证与交付：用 bash -n <script> 做语法检查，有 shellcheck 就运行；执行 chmod +x <script>。不要自己端到端运行，因为它会打开浏览器并在人类输入处阻塞；应静态追踪：步骤 1 的每个值都被采集，并落到步骤 1 指定的位置，每个 set_secret 名称都与 CI 中的 secrets.* 引用完全一致。然后告诉用户如何运行；如属可重复配置路径，可提交并在 README 中链接。
限制：资料未提供具体依赖版本、支持平台清单或价格信息，暂未提供。