wizard Skill：让 AI 自动生成交互式 Bash 向导的流程自动化神器

Skill超级捕获手 技术创作者 2026-07-28 23 阅读

wizard 是一个 AI Agent Skill，能够生成交互式 Bash 向导脚本，一步一步引导人工完成手动操作流程——第三方 SDK 配置、一次性数据迁移、项目状态迁移等。它能打开浏览器 URL、捕获页面值、向人工确认每一步、将敏感信息写入 .env 或 GitHub Secrets。相比让 AI 每次重新描述步骤，这个 Skill 把”重复向 AI 解释手动操作”这件恼人的事自动化了。随着 Claude Code / Cursor 等 AI 编程工具普及，wizard 在 2026 年 7 月周安装量从 16K 暴涨至 24K，成为 skills.sh 眼下最炙手可热的新晋 Skill 之一。

功能与原则

wizard 的核心能力是把复杂人工操作封装成可执行的 Bash 脚本。Skill 基于 template.sh 提供完整的 UX 交互框架，包括：

  • 进度条 + 剩余时间显示
  • 每步确认门（confirmation gates）
  • 跨平台 URL 自动打开（支持 WSL）
  • 隐藏式密钥输入（ask_secret）
  • 幂等 .env 插入（write_env）
  • GitHub Secrets / Variables 写入（set_secret / set_var）
  • 完成后汇总报告

wizard 的设计原则是专注流程梳理而非 UX 打磨——框架层由 template.sh 统一提供，AI 只需梳理每个 Stage 的操作步骤和待捕获值，极大降低了编写高质量向导脚本的门槛。

认可度

  • 所属仓库：mattpocock/skills，截至 2026-07-28 约 192K Stars（GitHub）
  • skills.sh 安装量：截至 2026-07-28 约 89K（平台总计）
  • 周安装趋势：16,880 → 24,720 → 22,340 → 21,072（近期持续高位）
  • trending 排名：skills.sh 热门榜稳定在第 264 位（截至 2026-07-28）

链接

GitHub：https://github.com/mattpocock/skills（wizard 位于 skills/in-progress/wizard/）

技能页：https://skills.sh/mattpocock/skills/wizard

原作者

Matt Pocock（GitHub @mattpocock），TypeScript 教育领域知名 YouTuber / 开发者，mattpocock/skills 仓库 Star 数超 19 万，专注于为 AI Coding Tools（Claude Code、Cursor 等）提供高质量 Skill 规范与最佳实践。

介绍

wizard 解决的是一个长期困扰 AI 编程工具的痛点：当你需要让 Claude 或其他 AI Agent 帮你完成一个需要人工介入的操作（比如配置 OAuth、申请 API Key、连接第三方服务）时，每次都要重新描述步骤，既啰嗦又容易出错。

这个 Skill 的思路是：让 AI 先梳理完整的人工操作流程，然后生成一个可执行的 Bash 脚本。脚本会一步一步引导真正的人类用户完成操作——打开哪个 URL、点击什么按钮、复制什么值、粘贴到哪。值会被自动写入 .env 文件或 GitHub Secrets，AI 下次运行时直接读取环境变量，不需要再问人工。

整个交互体验由 template.sh 提供开箱即用的解决方案，内置进度条、确认门、错误处理和最终报告。AI 的工作被压缩成：理解目标状态 → 梳理 Stage 列表 → 用 stage 函数编写每个步骤。框架的稳定性和 UX 一致性由模板保证，AI 无需操心脚本健壮性。

特点

  • 幂等 .env 管理：同一值重复运行不会重复追加，而是更新已有键
  • 隐藏式密钥输入：敏感信息（密码、Token）不会回显在终端
  • GitHub Secrets 写入：直接通过 gh secret / gh variable 命令写入 CI 环境，脚本运行完 CI 就能用
  • 跨平台 URL 打开：支持 macOS、Windows、Linux 和 WSL
  • 确认门设计：不可逆操作（如数据删除）强制人工确认，防止误操作
  • Stage 化流程：每个 Stage 专注一个任务，操作内容不滚动，方便人工跟进
  • 临时性优先：脚本默认是一次性工具，运行完可删除，保持仓库干净

使用方法

1. 梳理流程（AI 完成）

让 Agent 理解你要完成的手动操作后，先读取项目配置文件（.env、.env.example、.github/workflows/*、框架配置等），了解需要哪些值，再向人工确认 Stage 列表。

2. 生成向导脚本（AI 完成）

# AI 从 template.sh 复制脚本到目标路径
cp template.sh scripts/my-setup-wizard.sh

# AI 用 stage 函数填充每个步骤
# 示例结构：
stage "获取 GitHub OAuth Token" "从 https://github.com/settings/tokens 生成" 
  ask GITHUB_TOKEN "输入 GitHub Personal Access Token（不会显示）" 
  write_env GITHUB_TOKEN

3. 验证脚本

bash -n scripts/my-setup-wizard.sh  # 语法检查
chmod +x scripts/my-setup-wizard.sh

4. 运行脚本（人工完成）

./scripts/my-setup-wizard.sh
# 脚本会逐一打开 URL，引导人工完成每步操作

使用场景与人群

适用场景：
– 团队新成员首次环境配置（GitHub OAuth、第三方 API Key）
– 项目从 Heroku 迁移到 Railway / Vercel 的一次性迁移流程
– 开放平台接入（Stripe Webhook、SendGrid、Sentry）的手动配置引导
– 多人协作项目的 Secrets 初始化

目标用户：
– AI Coding 工具（Claude Code、Cursor、Cline）重度使用者
– 需要规范团队开发环境配置流程的技术负责人
– 需要让 AI 代理完成”人工先决步骤”的 DevOps 工程师

输入与输出案例

案例 1：配置 GitHub OAuth

  • 输入（AI prompt）：用 wizard 帮我创建一个 GitHub OAuth App 配置向导，需要捕获 Client ID 和 Client Secret，并写入 .env 和 GitHub Secrets
  • 输出：生成 scripts/setup-github-oauth.sh，运行后：
  • 自动打开 https://github.com/settings/developers
  • 提示人工填写 App 名称和回调 URL
  • 引导人工复制 Client ID 和 Client Secret
  • 自动写入 .env：GITHUB_CLIENT_ID=xxx
  • 自动写入 GitHub Secrets：gh secret set GITHUB_CLIENT_SECRET --body xxx

案例 2：Stripe Webhook 本地配置

  • 输入：Stripe Webhook 需要本地转发，手动步骤多容易忘，用 wizard 做一个引导脚本
  • 输出：生成 scripts/stripe-webhook.sh，运行后：
  • 打开 Stripe Dashboard → Webhooks 页面
  • 引导添加本地端点 http://localhost:4242/webhook
  • 捕获 Signing Secret 并写入 .env
  • 提示启动转发：stripe listen --forward-to localhost:4242/webhook
  • 每步显示剩余时间和进度条

GitHub: https://github.com/mattpocock/skills

评论区

0 条评论

登录后可评论。

Skill超级捕获手 23 阅读