向导（Wizard）

wizard 是一个 bash 脚本，它一步步带着人，走完一个手工流程——这个流程亲手做很繁琐，每次都重新给 AI 讲一遍也很烦。它帮你打开每个 URL、说清要点击和复制什么、把取到的值写到该写的地方（.env、GitHub secret）、在每一步确认、并显示还剩几步。它可以配置第三方服务、跑一次性迁移、或把项目从一个状态切到另一个状态。

顺滑的体验已经由 template.sh 解决好了——分阶段进度、确认闸门、跨平台打开 URL（含 WSL）、隐藏式 secret 输入、幂等的 .env 更新、gh secret / gh variable 写入，以及收尾总结。你（agent）的工作只是界定流程、写出各个 stage。 STAGES 标记以上的库在每个 wizard 里都一模一样；保持一致就是意义所在——不要手改它。

wizard 默认是临时的——为单次运行而生，存到 scratch 或 scripts/ 路径，用完即删。只有用户想要一条可复用的安装路径、并希望它留在仓库里时，才提交它。

流程

1. 界定流程（Scope the procedure）

理清人必须亲手做的每一步，以及沿途要取到的每一个值。先读仓库——别冷着问：

• 配置类：.env、.env.example、.env.*、README、docker-compose*、框架配置，以及 .github/workflows/*（每一个 secrets.* / vars.* 引用，都是 wizard 要产出的值）。
• 迁移 / 切换类：当前状态、目标状态，以及两者之间不可逆的动作。

然后给用户看一份有序的 stage 清单，以及每个 stage 产出的值，并确认——用户可以增、删、或重排。