#wizard

人工步骤向导。生成一个交互式 bash 向导，逐步骤带人走完只能人做的流程：开通基础设施、配置凭据/CI 密钥、走不熟悉的第三方面板、跑一次性迁移或切换。

别为 agent 自己能做的步骤调用它——只有人真正在循环里时才用它。agent 能自己做就该自己做。

#概述

向导每一步：打开 URL → 精确说点什么/复制什么 → 捕获值 → 写进该去的地方（.env、GitHub secrets）→ 每阶段确认 → 显示还剩几阶段。它可能配置第三方服务、跑一次性迁移、把项目从一个状态移到另一个。

令人愉悦的 UX 已经由 template.sh 解决了：逐阶段进度、确认门、跨平台 URL 打开（含 WSL）、隐藏密钥输入、幂等 .env upsert、gh secret/gh variable 写入、收尾摘要。你只负责划定流程和编写阶段。STAGES 标记以上的库部分每个向导都相同——一致性就是要点，绝不手改它。

向导默认一次性的：为一次运行构建，存到 scratch 或 scripts/ 路径，干完就删。只有用户想要可重复的设置路径才提交进仓库。

#日常使用

> 我需要配置 Stripe 的 API key，帮我做一个设置向导
> 帮我把这个迁移做成向导脚本

#实战

#1. 划定流程

算出人必须做的每个手动步骤和沿途捕获的每个值。先读仓库，别冷问：

• 设置类：.env、.env.example、.env.*、README、docker-compose*、框架配置、.github/workflows/*——每个 secrets.* / vars.* 引用都是向导必须产出的值
• 迁移/转换类：当前状态、目标状态、之间不可逆的动作

然后给用户看有序阶段列表和每阶段产出的值并确认：可以增删改序。

完成标准：每阶段按顺序命名，每个捕获值都知道 (a) 人从哪拿到它，(b) 写去哪（.env、GitHub secret、两者、或无处——有些阶段是纯动作），(c) 是否机密（隐藏输入）或公开。

#2. 映射每阶段的旅程

给每阶段写人走的精确路径：哪个 URL、在那做什么、值显示在哪、填哪个变量。例如 "Dashboard → Developers → API keys → Reveal test key → copy"。不知道实际 UI 或确切命令就明说并问用户或查文档：绝不编造可能不存在的步骤。

#3. 编写向导

复制 template.sh 到目标路径，用 stage 替换示例阶段（按依赖顺序）。用库辅助函数：stage、say/step、open_url、ask/ask_secret、write_env、set_secret/set_var、pause/confirm。设 TOTAL_STAGES 为阶段数。

保持模板定的标准：先开 URL 再要它的值；机密用 ask_secret；每个持久化值 write_env；只有 CI 真需要的值才 set_secret；不可逆动作前 confirm。每个 stage 清屏只显示当前步骤——一阶段一个聚焦任务，别让需要的信息滚出视野。不碰标记以上的库部分。

#4. 验证和交接

• bash -n <script> 语法检查；有 shellcheck 就跑
• chmod +x <script>
• 别自己端到端跑——它会开浏览器并阻塞等人输入。静态追踪：步骤 1 的每个值都被捕获并落到步骤 1 说的地方，每个 set_secret 名字精确匹配 CI 里的 secrets.* 引用
• 告诉用户怎么跑。可重复的设置路径就提交并链接到 README——让下一个人跑脚本而不是再问一次 AI

#与其它技能的关系

• 独立技能：模型触达——agent 撞到只有你能过的墙时就伸手去够它
• 互补：to-questionnaire 从人脑里挖知识；wizard 从人手里收集操作