一句话

生成一个交互式 bash 向导脚本，带人走完只有人能做的步骤：开服务、配密钥、点陌生 dashboard、一次性迁移或切换。

何时用

• 适合：下一步卡在得人来做的事上（开 key、配 CI secrets、点第三方 dashboard、一次性迁移）；比写 README 强，脚本能跑且步骤过时了会显式失败。
• 不适合：agent 自己能做的步骤（它自己做）；要决定做什么（那是 grilling 和 to-spec 的事）。

怎么用

给我做个向导脚本，带我配齐跑起来需要的四个服务密钥

1. 先读 repo 摸清手动步骤和要收的值：.env*、README、docker-compose、workflows 里每个 secrets.*/vars.* 引用。
2. 每个 stage 写清人的路径：开哪个 URL、点哪、哪个值、填到哪；不知道的 UI 或命令就问，不编造。
3. 用 template.sh 的 STAGES 库写脚本：库本体不改；先开 URL 再要值、秘密用 ask_secret、持久值 write_env、不可逆操作前 confirm。
4. bash -n 加 shellcheck 静态验证，不端到端自跑；核对每个 set_secret 名和 CI 的 secrets.* 引用一致，告诉用户怎么跑。

产出

• 一个 bash 向导脚本：默认一次性放 scratch 或 scripts/、用完可删；可复用的才 commit 进 repo。

要点与坑

• UX 已被 template.sh 解决（进度、确认门、跨平台开 URL、隐藏输入、.env 幂等 upsert、gh secret 写入），你只负责定范围和写 stages。
• 每个 stage 清屏，保持一个 stage 一件聚焦的事。

关联

• 同类：matt-setup-pre-commit、matt-git-guardrails-claude-code
• 所属：00-matt-概览