SuperAPI AI 工具集

wizard

部署与运维

查看项目

更新于 10-23 16:19

技能介绍

Wizard 是一个用于生成交互式 Bash 向导的技能。它面向一类手动操作流程:这些事情由人来做很繁琐,每次让智能体重新解释也很繁琐,于是把它做成一个脚本,逐阶段引导人类完成。脚本会打开每个需要的 URL,说明具体点击和复制什么,收集用户输入的值,写入应有的位置(.env、GitHub secrets),在每个阶段进行确认,并显示还剩多少阶段。典型用途包括配置第三方服务、执行一次性迁移,或把项目从一个状态迁移到另一个状态。

交互体验由 template.sh 统一解决,包括逐阶段进度、确认关卡、跨平台打开 URL(含 WSL)、隐藏方式输入敏感信息、幂等的 .env 更新、写入 gh secret / gh variable,以及结束摘要。使用者的工作只是界定流程范围并编写各阶段。模板中 STAGES 标记以上的库代码在每个向导中都相同,这种一致性正是设计目的,不应手动修改。

向导默认是一次性的:为单次运行而构建,保存在 .scratch/ 或 scripts/ 下,任务完成后删除。只有当用户希望获得可重复、存放在仓库中的安装路径时才提交。

使用流程分为四步。第一步是界定流程:读取仓库中的 .env、.env.example、README、docker-compose、框架配置,以及 .github/workflows 中引用的 secrets/vars,梳理出人类必须执行的每个手动步骤和沿途收集的每个值;对非敏感值尽量从 git remote、配置、基础设施文件或惯例默认值中推导出默认值,然后与用户确认阶段顺序和每个阶段产出的值。

第二步是为每个阶段梳理具体路径:写明应打开的 URL、在那里做什么、值在哪里显示、填入哪个变量。对于不确定的当前界面或命令,应当提问或查文档,而不是编造步骤。

第三步是编写向导:复制 template.sh 到目标路径,按依赖顺序把示例阶段替换为实际阶段,使用 stage、say/step、open_url、ask/ask_secret、write_env、set_secret/set_var、pause/confirm 等库函数,并把 TOTAL_STAGES 设为实际阶段数。要求为已知默认值传入 ask 的第三个参数,在询问值之前先打开对应 URL,敏感信息使用 ask_secret,所有持久化值用 write_env 写入,仅 CI 真正需要的值用 set_secret 写入,不可逆操作前进行确认。绝不应把敏感信息作为默认值写入脚本。

第四步是验证与交付:用 bash -n 检查语法,可用时运行 shellcheck,执行 chmod +x,并通过静态检查而非实际运行来核对(因为脚本会打开浏览器并阻塞等待人工输入),最后告知用户如何运行;若属于可重复的安装路径,则提交并在 README 中链接。由于资料未提供更多关于分类、平台兼容范围或具体价格的说明,这些方面暂未提供。