SuperAPI AI 工具集

wizard

办公与效率

查看项目

更新于 10-28 16:14

技能介绍

Wizard 是一个以 bash 脚本形式存在的交互式向导技能,目标是让 AI 生成一个引导真人逐步完成手动流程的脚本,而不是由 AI 反复口头解释这些步骤。典型用途包括配置第三方服务、设置凭据、写入 CI 密钥,以及执行一次性迁移或让项目从一个状态转换到另一个状态。

主要能力:模板 template.sh 已解决交互体验——按阶段显示进度、设置确认门禁、跨平台打开 URL(包括 WSL)、隐藏方式输入密钥、幂等的 .env upsert(新增或更新)、写入 gh secret 与 gh variable,并在结束时给出摘要。配套的 envfile.py 负责序列化 dotenv 字面量数据,支持带引号和多行的安全值,保留已有完整记录与文件模式,遇到不支持的引号写法会拒绝写入而不做部分写入。

使用方式:先梳理流程,阅读仓库中的 .env、.env.example、README、docker-compose、框架配置和 .github/workflows(每个 secrets.* / vars.* 引用都是向导需要产出的值),列出有序阶段及每个阶段产出的值并请用户确认;然后为每个阶段写明具体操作路径(打开哪个 URL、在哪里取值、填入哪个变量),不确定当前 UI 或命令时要向用户确认,不能凭空编造步骤;接着将 template.sh 复制到目标路径并把 envfile.py 放在旁边,确认 Python 3 可用,用库中的 stage、say/step、open_url、ask/ask_secret、write_env、set_secret/set_var、pause/confirm 等辅助函数替换示例阶段,设置 TOTAL_STAGES;最后用 bash -n(如有 shellcheck 也运行)做语法校验,chmod +x,并静态核对每个值都有正确落点、每个 set_secret 名称与 CI 中的 secrets.* 引用完全一致。不要自行端到端运行脚本,因为它会打开浏览器并阻塞在人工输入上。

限制与注意事项:向导默认是一次性的,保存到临时或 scripts/ 路径,任务完成后删除;仅当用户希望获得可重复的设置路径时才提交仓库。不要手动编辑 STAGES 标记之上的库代码,各向导中的这部分代码完全一致。envfile.py 以 Node 的 dotenv 语法及兼容解析器为目标,改用其他消费方时需先验证再存储真实值。帮助程序拒绝不支持的引号写法且不做部分写入。该技能本身未提供收费、价格、平台支持范围等更多信息。