用途:wizard 是一个由 AI 生成的交互式 bash 脚本,用于把难以手动完成、也难以反复向 AI 解释的手动流程,编排成带人逐步操作的向导。典型场景包括配置第三方服务、执行一次性迁移、设置凭据或 CI,或把项目从一个状态迁移到另一个状态。
主要能力:向导逐阶段展示进度,在每个阶段打开对应 URL,明确说明该点击和复制什么,捕获值并写入 .env、GitHub secrets 等位置,在每步确认,并显示剩余阶段数。其 UX 由 template.sh 提供:跨平台打开 URL(含 WSL)、隐藏输入密钥、幂等的 .env 写入、gh secret/gh variable 写入以及结束摘要。用户只需界定流程并编写各阶段内容;STAGES 标记上方的库在每个向导中相同,不应手动修改。默认情况下向导是一次性的,运行后即可删除;只有需要可重复的 setup 路径时才提交到仓库。
使用方式:先阅读仓库(.env、.env.example、README、docker-compose、框架配置、.github/workflows 等)确定所有人工步骤与需捕获的值,再确认阶段顺序和每个值来源与写入位置。然后为每个阶段逐一写出具体路径,例如“Dashboard → Developers → API keys → Reveal test key → copy”,顺序按依赖排列,把 template.sh 复制到目标路径,使用库辅助函数 stage、say/step、open_url、ask/ask_secret、write_env、set_secret/set_var、pause/confirm 编写,并设置 TOTAL_STAGES。最后用 bash -n 或 shellcheck 静态检查,chmod +x 后交给用户运行;不要自己端到端运行,因为它会打开浏览器并阻塞在人工输入上。
限制:每个阶段应只聚焦一个任务,先打开 URL 再询问值,机密必须用 ask_secret,持久化值用 write_env,仅 CI 需要的值用 set_secret,不可逆操作前需确认。若不清楚当前 UI 或确切命令,应说明并询问用户或查阅文档,不要编造步骤。不应修改 STAGES 标记上方的库。其他细节资料未提供。