向导

向导（Wizard） 是一个 bash 脚本，逐步引导人类完成手动流程——这些流程手动做很繁琐，每次重新向 AI 解释也很麻烦。它会打开每个 URL，精确说明要点击什么和复制什么，捕获值，将其写入正确的位置（.env、GitHub secrets），在每个阶段确认，并显示剩余阶段数。它可能配置第三方服务、运行一次性迁移、或把项目从一个状态迁移到另一个状态。

便捷的 UX 已经由 template.sh 解决——分阶段显示进度、确认关卡、跨平台 URL 打开（含 WSL）、隐藏密文输入、幂等的 .env 写入、gh secret/gh variable 写入，以及一个结束汇总。你的工作只是界定流程范围并编写其阶段。 每个向导中 STAGES 标记上方的库代码都是相同的——这种一致性正是关键所在，永远不要手动编辑它。

向导默认是临时的——为一次运行而创建，保存在 scratch 或 scripts/ 路径下，任务完成后删除。仅当用户希望创建一个可重复的设置路径（应留在仓库中）时才提交它。

流程

1. 界定流程范围

找出人类必须执行的每一个手动步骤以及沿途捕获的每一个值。先阅读仓库——不要凭空提问：

• 对于设置：.env、.env.example、.env.*、README、docker-compose*、框架配置，以及 .github/workflows/*（每个 secrets.* / vars.* 引用都是向导必须产生的值）。
• 对于迁移或切换：当前状态、目标状态，以及两者之间的不可逆操作。

然后向用户展示有序的阶段列表以及每个阶段产生的值，并确认——他们可能会添加、删除或重新排序。