用途：wizard 是一个 bash 脚本，逐步带人走完手工流程，适合亲手做很繁琐、每次重讲也麻烦的操作用。可配置第三方服务、跑一次性迁移，或把项目从一个状态切到另一个状态。
主要能力：由 template.sh 提供分阶段进度、确认闸门、跨平台打开 URL（含 WSL）、隐藏式 secret 输入、幂等 .env 更新、gh secret / gh variable 写入，以及收尾总结。协助函数包括 stage、say / step、open_url、ask / ask_secret、write_env、set_secret / set_var、pause / confirm，并将 TOTAL_STAGES 设为实际 stage 数。向导默认临时，存到 scratch 或 scripts/，用完即删；只有用户需要可复用安装路径时才提交进仓库。
使用方式：先界定流程，读 .env、README、docker-compose、框架配置及 CI 中的 secrets.* / vars.* 引用，列出有序 stage 清单和要取的值并确认，明确每个值从哪来、写到哪、是否 secret。再为每个 stage 画出人的操作路径，不确定的 UI 或命令要如实说明，不得编造。随后复制 template.sh，替换示例 stage，按依赖顺序编写，并使用辅助函数。最后用 bash -n 和 shellcheck 验证，chmod +x，不要端到端跑，改为静态追溯每个值都被取到并落到约定位置，且 set_secret 名称与 CI 引用精确对应。
限制：只用于人必须亲手完成的步骤，agent 能做的不要用；不可手改 STAGES 标记以上的库；每个 stage 清屏并只做一件聚焦的事。