Wizard

wizard 是一个 bash 脚本，它一步一步引导人完成一项手动流程——这类流程手动做很繁琐，每次重新向 AI 解释一遍也很繁琐。它会打开每个 URL，准确说明该点什么、该复制什么，捕获这些值，把它们写到该去的地方（.env、GitHub secrets），在每个阶段确认，并显示还剩多少个阶段。它可能用于配置第三方服务、运行一次性 migration，或把项目从一种状态迁移到另一种状态。

出色的 UX 已经由 template.sh 解决——逐阶段的进度、confirmation gates、跨平台 URL 打开（含 WSL）、隐藏的 secret 输入、幂等的 .env upserts、gh secret/gh variable 写入，以及收尾 summary。你的工作只是确定流程范围并编写它的各个 stage。 STAGES 标记之上的 library 在每个 wizard 中都完全相同；这种一致性正是重点——永远不要手动编辑它。

Wizard 默认是临时的——为单次运行而构建，保存到 scratch 或 scripts/ 路径，任务完成后删除。只有当用户想要一条应留在 repo 中的可重复 setup 路径时，才 commit 它。

Process

1. Scope the procedure

梳理出人必须执行的每一个手动步骤，以及沿途捕获的每一个值。先读 repo——不要凭空发问：

• 对于 setup：.env、.env.example、.env.*、README、docker-compose*、framework config，以及 .github/workflows/*（每一处 secrets.* / vars.* 引用都是 wizard 必须产出的一个值）。
• 对于 migration 或 transition：当前状态、目标状态，以及两者之间不可逆的操作。

然后向用户展示有序的 stages 列表以及每个 stage 产出的值，并确认——他们可能增删或重新排序。