用途
wizard 用于生成一个交互式 bash 向导，逐步引导人类完成那些手动执行起来既繁琐、又难以每次向 AI 重新解释的手动流程。它可能配置第三方服务、运行一次性迁移，或把项目从一个状态迁移到另一个状态。
主要能力
向导是 bash 脚本：它会打开每个 URL、明确指出要点什么和复制什么、捕获相应值、把它们写入该去的地方（.env、GitHub secrets）、在每个阶段进行确认，并显示还剩多少阶段。其愉悦的用户体验已由 template.sh 解决：分阶段进度、确认关卡、跨平台 URL 打开（含 WSL）、隐藏式密钥输入、幂等的 .env 更新（upsert）、gh secret/gh variable 写入，以及收尾总结。使用者的工作只是界定流程范围并编写其各阶段内容。STAGES 标记之上的库在每个向导中都是完全相同的，这种一致性正是关键：切勿手动编辑它。
向导默认是临时的：为一次运行而构建，保存到 scratch 或 scripts/ 路径，任务完成后删除。只有当用户希望有一条可重复、应留在仓库中的安装路径时才提交它。
使用方式
该技能按以下流程工作：
-
界定流程范围：梳理出人类必须采取的每个手动步骤，以及沿途捕获的每个值。先阅读仓库，而不是空口询问。对于 setup：.env、.env.example、.env.、README、docker-compose、框架配置，以及 .github/workflows/（每个 secrets. / vars.* 引用都是向导必须产出的值）。对于迁移或过渡：当前状态、目标状态，以及它们之间不可逆的操作。然后把有序的阶段列表和每个阶段产出的值展示给用户并确认：他们可以增加、删除或重新排序。完成标准：每个阶段都按顺序命名，且对于每个捕获的值，你知道（a）人类从哪里获取它，（b）它写到哪里（.env、一个 GitHub secret、两者，或哪里都不写；有些阶段是纯操作），（c）它是私密（隐藏输入）还是公开的。
-
梳理每个阶段的路径：为每个阶段写出人类所遵循的精确路径：打开哪个 URL、在那里做什么、某个值在哪里显示、它填入哪个变量，例如“Dashboard → Developers → API keys → Reveal test key → copy”。当你并不真正了解当前 UI 或确切命令时，要如实说明并询问用户或查阅文档：绝不要编造可能不存在的步骤。完成标准：每个阶段都能追溯到陌生人也能照做的具体指令。
-
编写向导：把 references/template.sh 复制到目标路径。把示例阶段替换为每个步骤一个阶段，按依赖顺序排列。使用库中的辅助函数：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，在任何不可逆操作之前先确认。每个阶段会清屏，使只有当前步骤可见：让一个阶段只做一项聚焦任务，以免人类需要的内容被滚走。不要改动标记之上的库。
-
验证并交付：bash -n <script>；若可用则运行 shellcheck。chmod +x <script>。不要自己端到端运行它：它会打开浏览器并阻塞在人类输入上。改为静态追踪：第 1 步中的每个值都被捕获并落到第 1 步所说的位置，且每个 set_secret 名称都恰好匹配 CI 中的一个 secrets.* 引用。告诉用户如何运行它。如果这是一条可重复的安装路径，提交它并从 README 链接过去，这样下一个人就会运行脚本而不是问 AI。
适用场景
- 供给基础设施
- 设置凭据或 CI 密钥
- 走查不熟悉的第三方仪表盘
- 执行一次性迁移或切换
不应对智能体自己就能执行的步骤调用此技能。
最佳实践
保持上游流程完整；明确记录偏差，而不是悄悄即兴发挥。在该技能标记为属于用户的每个决策点停下并把控制权交还用户。优先采用小的可逆改动，并陈述假设而不是掩盖它们。
限制
不要自己端到端运行该向导，因为它会打开浏览器并阻塞在人类输入上；应改为静态追踪验证。该技能为临时性质，任务完成后应删除，除非需要作为可重复的安装路径提交到仓库。其他具体功能、收费、价格、平台、效果或使用步骤资料暂未提供。