wizard
生成一个交互式 bash 向导,引导人类完成只能由他们执行的步骤。适用于配置基础设施、设置凭证或 CI 密钥、操作不熟悉的第三方仪表板,或运行一次性迁移或切换时。不要针对代理自身可以执行的步骤调用此功能。
技能说明mattpocock/skills
生成一个交互式 bash 向导,引导人类完成只能由他们执行的步骤。适用于配置基础设施、设置凭证或 CI 密钥、操作不熟悉的第三方仪表板,或运行一次性迁移或切换时。不要针对代理自身可以执行的步骤调用此功能。
技能简介
Wizard 技能用于生成一个交互式 bash 向导脚本,引导人类逐步完成只有他们才能执行的操作。它解决 AI 无法代替人类手动操作的场景,例如设置凭证、配置第三方服务、运行一次性迁移,并自动完成关键信息的捕获与写入。
使用场景
- 配置基础设施或初始化环境
- 设置 API 凭证、CI Secrets 或 GitHub Variables
- 指导操作不熟悉的第三方仪表板
- 运行一次性数据迁移或服务切换
- 在仓库中固化可重复执行的配置流程
使用方法
- 复制官方提供的
template.sh到目标路径作为基础。 - 在
STAGES标记下方编写你的阶段脚本;标记上方的库代码为通用部分,不要手改。 - 使用库内置函数:
stage、say/step、open_url、ask/ask_secret、write_env、set_secret/set_var、pause/confirm。 - 设置
TOTAL_STAGES为实际阶段数。 - 检查脚本语法:
bash -n <script>;如有shellcheck可运行shellcheck <script>。 - 赋予执行权限:
chmod +x <script>。 - 不要自己端到端运行向导(它会打开浏览器并阻塞等待输入);请静态追踪每个阶段的取值与写入位置。
- 告知用户运行方式;若该向导是可重复使用的配置流程,可提交到仓库并从 README 链接。
注意事项
- 向导默认是一次性的,运行后即可删除;仅当用户需要保留可重复的设置路径时才提交。
- 不要编造不存在的 UI 步骤或命令;不确定时询问用户或查阅官方文档。
- 每个阶段应聚焦单一任务,避免重要信息滚出屏幕。
- 秘密值使用
ask_secret隐藏输入;只将 CI 真正需要的值通过set_secret写入。