用途：wizard 用于生成一个交互式 bash 向导，逐步引导人类完成那些手工做很繁琐、且每次都要重新向 AI 解释的手动流程，例如配置第三方服务、设置凭据或 CI、执行一次性迁移，或把项目从一种状态转为另一种状态。
主要能力：向导会打开每个 URL，明确说明该点什么、复制什么，捕获输入的值，并把它们写到该去的地方（.env、GitHub secrets），在每个阶段确认，并显示还剩多少阶段。交互体验由 template.sh 提供，包括分阶段进度、确认闸口、跨平台打开 URL（含 WSL）、隐藏式密钥输入、幂等的 .env upsert、gh secret/gh variable 写入以及结尾总结。使用者只需界定流程并编写各阶段，STAGES 标记之上的库在每个向导中都相同，不要手改。
使用方式：先梳理人工步骤与沿途要捕获的每个值，阅读仓库中的 .env、.env.example、README、docker-compose、框架配置和 .github/workflows/，确认哪些 secrets. / vars.* 需要由向导产生；随后向用户展示有序阶段列表并确认；再为每个阶段写出具体路径（打开哪个 URL、做什么、值显示在哪、填入哪个变量）；然后复制 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，并告知用户如何运行。向导默认是临时的，用完可删除；只有用户希望作为可重复的仓库内设置路径时才提交。
限制：不要自己端到端运行，因为它会打开浏览器并阻塞等待人工输入，应静态追踪验证；每个 set_secret 名称必须与 CI 中的 secrets.* 引用完全一致。资料未提供官方收费、价格、支持平台或效果信息。