向导

向导是一个 bash 脚本，引导人一步步完成手动流程。这类流程手动操作很繁琐，每次重新向 AI 解释也很繁琐。向导会打开每个 URL，说明点击哪里、复制什么，收集输入的值，写入对应位置（.env、GitHub secrets），在每个阶段请求确认，并显示剩余阶段数。它可以用于配置第三方服务、执行一次性迁移，或把项目从一种状态迁移到另一种状态。

template.sh 已经实现了好用的交互体验：分阶段进度、确认步骤、跨平台打开 URL（包括 WSL）、隐藏密钥输入、幂等写入 .env、通过 gh secret 和 gh variable 写入、结束时汇总。你的工作只是梳理流程并编写各个阶段。 STAGES 标记之上的库代码在每个向导中完全相同，这种一致性正是它的价值：库代码保持原样，只编辑标记之下的部分。

向导默认是一次性的：为一次运行而写，保存在临时目录或 scripts/ 中，事情完成后删除。只有用户需要一条保留在仓库中、可重复执行的配置流程时，才提交它。

过程

1. 梳理流程

弄清人必须完成的每个手动步骤，以及过程中需要收集的每个值。先阅读仓库，不要一开始就提问：

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

然后向用户展示阶段的顺序清单，以及每个阶段产出的值，并请用户确认：用户可能会增加、删除或调整顺序。