用途：wizard 用于生成一个 bash 脚本，逐步引导人工完成繁琐的手动流程，例如配置第三方服务、执行一次性迁移或改变项目状态。它适合在配置基础设施、设置凭据或 CI 等场景使用。
主要能力：基于 template.sh 模板，已解决分阶段进度、确认门、跨平台打开 URL（含 WSL）、隐藏密钥输入、幂等 .env 更新、gh secret/gh variable 写入以及结束摘要。用户只需界定流程并编写各阶段。
使用方式：先梳理所有手动步骤和需捕获的值，阅读仓库中的 .env、README、docker-compose、框架配置和 .github/workflows 等文件；再为每个阶段映射具体路径；然后复制 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，并告知用户运行方式。Windows 上需用 Git Bash 或 WSL 运行，PowerShell 无法直接执行。
限制：向导默认是临时的，仅用于一次运行，完成后删除；只有用户希望可重复使用时才提交到仓库。不要手动编辑 STAGES 标记以上的库代码。不要自行端到端运行，因为它会打开浏览器并阻塞等待人工输入，应静态追踪验证。若不清楚当前 UI 或确切命令，应询问用户或查阅文档，不要编造步骤。