用途：wizard 用于编写由人类显式执行的 Bash 向导脚本，覆盖手动设置、凭据、迁移或切换等需要人工操作的流程。不适用于智能体可直接安全完成的工作、后台自动化或无人值守的提供商变更，也不应作为调度器或工单流程使用。
主要能力：先在读取仓库后定义有序阶段、每阶段可观测的完成条件、每个捕获值的来源与敏感性与目的地、涉及的本地方案/浏览器/提供商/凭据存储或不可逆操作，以及仍须人工执行的步骤。脚本使用模板 helper：stage、say、step、note、warn、pause、confirm 用于人机引导；ask 用于非敏感单行输入；ask_secret 用于关闭回显的敏感输入；write_env 仅写入用户批准的本地环境；open_url 仅打开已审查 URL；set_secret 仅设置已审查的提供商密钥名。阶段计数为确定值（如 Stage 2/5），不显示时钟、速率或预测。
使用方式：复制 template.sh，只编辑其 STAGES 标记以下的部分，设置 WIZARD_CONFIGURED=1，将 TOTAL_STAGES 设为实际 stage 调用数。浏览器打开需 WIZARD_ALLOW_BROWSER=1，否则仅显示 URL；提供商写入需 WIZARD_ALLOW_PROVIDER=1 并在写入前交互确认。缺失工具、认证、选项或确认时应如实转为人工后续。校验时运行 bash -n <wizard>，有 shellcheck 时运行 shellcheck <wizard>，仅在经校验的临时目录中用 fixture 模式测试，并确保 fixture 两次执行后的环境文件逐字节一致。
限制：绝不运行生成的向导、复制的模板或任何实际阶段；不得在脚本、示例、测试、日志、命令参数或移交内容中嵌入真实凭据、令牌、Cookie 或个人值；敏感变量在用完后立即取消设置。fixture 模式优先于各类 opt-in，开启时浏览器与提供商 helper 必须在命令发现或执行前返回，且仅可写入调用方提供的临时 ENV_FILE。不得为通过测试而削弱 fixture 防护，AFK 实现、审查、QA 或验证期间均不得执行实际向导。
返回内容：向导路径、有序阶段列表、阶段数、值到目的地映射、不含值的敏感值名称、本地变更列表、外部操作列表、校验结果，以及人类可运行的确切命令；并说明默认缺少浏览器/提供商 opt-in，且尚未执行。