用途：Wizard 用于把繁琐、需要反复向 AI 解释的手动流程固化为一个 bash 脚本，由脚本逐步引导人类完成。典型场景包括配置第三方服务、设置凭证或 CI 密钥、操作不熟悉的第三方面板、执行一次性迁移或状态切换。它不替人类执行本应由人类完成的步骤。
主要能力：分阶段显示进度、确认关卡、跨平台打开 URL（含 WSL）、隐藏密文输入、幂等的 .env 写入、gh secret/gh variable 写入，以及结束汇总。每个阶段清屏，使当前步骤成为唯一可见内容。
使用方式：先界定流程范围，阅读仓库中的 .env、.env.example、README、docker-compose、框架配置和 .github/workflows 等，找出每个手动步骤与需捕获的值，并向用户确认阶段顺序。再为每个阶段绘制精确路径，说明打开哪个 URL、做什么、值在哪里显示、填充哪个变量。然后复制 template.sh 到目标路径，用库辅助函数（stage、say/step、open_url、ask/ask_secret、write_env、set_secret/set_var、pause/confirm）编写各阶段，并设置 TOTAL_STAGES。最后用 bash -n 和 shellcheck 验证，chmod +x，静态跟踪每个值是否被捕获并写入正确位置，set_secret 名称是否精确匹配 CI 中的 secrets.* 引用。
限制：不要自己端到端运行，因为它会打开浏览器并阻塞等待人类输入。向导默认是临时的，保存在 scratch 或 scripts/ 路径下，任务完成后删除；仅当用户希望创建可重复的设置路径时才提交。不要手动编辑 STAGES 标记上方的库代码。若不确定当前 UI 或确切命令，应说明并询问用户或查阅文档，不要编造步骤。