wizard

生成一个交互式 bash 向导,引导人类完成只能由他们执行的步骤。适用于配置基础设施、设置凭证或 CI 密钥、操作不熟悉的第三方仪表板,或运行一次性迁移或切换时。不要针对代理自身可以执行的步骤调用此功能。

提供方:mattpocock/skills调用次数:2.9k收藏:377更新:2026/08/28

技能说明mattpocock/skills

生成一个交互式 bash 向导,引导人类完成只能由他们执行的步骤。适用于配置基础设施、设置凭证或 CI 密钥、操作不熟悉的第三方仪表板,或运行一次性迁移或切换时。不要针对代理自身可以执行的步骤调用此功能。

技能简介

Wizard 技能用于生成一个交互式 bash 向导脚本,引导人类逐步完成只有他们才能执行的操作。它解决 AI 无法代替人类手动操作的场景,例如设置凭证、配置第三方服务、运行一次性迁移,并自动完成关键信息的捕获与写入。

使用场景

  • 配置基础设施或初始化环境
  • 设置 API 凭证、CI Secrets 或 GitHub Variables
  • 指导操作不熟悉的第三方仪表板
  • 运行一次性数据迁移或服务切换
  • 在仓库中固化可重复执行的配置流程

使用方法

  1. 复制官方提供的 template.sh 到目标路径作为基础。
  2. STAGES 标记下方编写你的阶段脚本;标记上方的库代码为通用部分,不要手改。
  3. 使用库内置函数:stagesay/stepopen_urlask/ask_secretwrite_envset_secret/set_varpause/confirm
  4. 设置 TOTAL_STAGES 为实际阶段数。
  5. 检查脚本语法:bash -n <script>;如有 shellcheck 可运行 shellcheck <script>
  6. 赋予执行权限:chmod +x <script>
  7. 不要自己端到端运行向导(它会打开浏览器并阻塞等待输入);请静态追踪每个阶段的取值与写入位置。
  8. 告知用户运行方式;若该向导是可重复使用的配置流程,可提交到仓库并从 README 链接。

注意事项

  • 向导默认是一次性的,运行后即可删除;仅当用户需要保留可重复的设置路径时才提交。
  • 不要编造不存在的 UI 步骤或命令;不确定时询问用户或查阅官方文档。
  • 每个阶段应聚焦单一任务,避免重要信息滚出屏幕。
  • 秘密值使用 ask_secret 隐藏输入;只将 CI 真正需要的值通过 set_secret 写入。