# Guided Steps

> 当一次配置里有只有人能做的步骤时使用——第三方后台、凭证、CI secret、开通服务、一次性迁移、切换上线。生成一个分阶段的交互式脚本：打开每个 URL、说清点什么复制什么、接住值、写到它该在的地方。Trigger words: wizard, human-only steps, provision, credentials, dashboard setup, CI secrets, cutover. 中文触发词：向导、人工步骤、开通、凭证、后台配置、CI 密钥、切换上线。

- Skill: `tcuzzo/guided-steps-7` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tcuzzo/guided-steps-7`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tcuzzo/guided-steps-7/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- License: MIT
- Author: Tcuzzo (https://skillmd.com/u/tcuzzo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tcuzzo/guided-steps-7

---


# Human Steps Wizard——人工步骤向导
**Effort:** free — 编写纪律加一次静态语法检查；零模型调用。消除：每次运行都把同一条只有人能点的路径重新解释一遍，以及顺手把密钥粘进被 git 跟踪的文件。

有些步骤只有人能做：在第三方后台里点来点去、创建凭证、确认开通页面。手工做一遍很烦，每次重新解释一遍更烦。向导把它们变成一次有引导的运行：一个分阶段的交互式 shell 脚本，打开每个 URL、精确说清点什么、复制什么、接住值、写到它该在的地方。

## 什么时候用

- 一次配置需要人去操作 API 够不着的界面——后台、控制台、凭证页、CI secret 页、
  一次性迁移、切换上线。
- 路径长到每次重新解释都嫌疼。

什么时候不用：API 能做这一步（那就自动化——向导是最后手段），或者流程只有一两步（直接用大白话告诉人就行）。

## 形状

一个脚本，两个部分：

- **顶部的辅助函数库**——每个向导里完全相同，绝不手改。它提供：带进度的阶段标题
  （"第 3 步，共 7 步"）、人话旁白、跨平台打开 URL、密钥的隐藏输入、幂等的 `.env`
  更新（键存在就更新，不存在就追加）、写入你 CI 服务商的 secret 存储、一个确认/暂停
  步骤、以及结尾对所有已采集值的汇总。
- **标记线以下的阶段**——你唯一要写的部分。每个人工步骤一个阶段：打开 URL、说清
  点什么复制什么、接住值、写到目的地。把总阶段数设对，让进度显示诚实。

## 流程

1. **圈范围。** 读 env 示例文件、README、部署配置、CI workflow。它们引用的每个
   secret 或变量都是向导必须产出的值。把阶段顺序和涉及的值提前亮给人看——确认了
   计划再动笔。
2. **画出每个阶段的路线。** 每阶段一行：URL → 操作 → 值 → 目的地。人在开始之前就
   看到整条路。
3. **编写。** 复制模板。只写阶段部分；绝不碰函数库。旁白用大白话——跑这个脚本的人
   不一定是工程师。
4. **静态验证。** 语法检查（`bash -n`、shellcheck）、加可执行权限，然后逐阶段人工
   走查：每个 URL 对吗、每条指令清楚吗、每个写入目标正确吗？不要端到端跑——它会弹
   浏览器并阻塞等人输入。

## 硬规则

- **secret 绝不碰被跟踪的文件。** 采集到的值只落进 gitignore 的 `.env` 或 CI secret
  存储。脚本本身只带占位符；真实值由人在运行时粘贴。写进脚本里的真实密钥、主机名
  或个人信息，本身就是 bug。
- **每次远程写入都单发、有界。** 写 secret 存储就是一次 API 调用：不搞重试循环、
  不狂敲。大声失败，让人重跑这个阶段。
- **默认用完即弃。** 向导为一次运行而建，跑完删掉。只有人明确要一条可重复的配置
  路径时才提交——而且提交的向导依然只带占位符。
- **确认步骤是人自己的暂停键，不是一道门。** 它存在是让人检查自己的操作——绝不是
  给人加审批摩擦。

## 搭配使用

- [session-handoff](../session-handoff/SKILL.md)——运行被拆开时，记下哪些阶段已经跑过。
- [human-voice](../human-voice/SKILL.md)——每个阶段旁白所用的语气。
- [bounded-loops](../bounded-loops/SKILL.md)——远程写入背后的不狂敲规则。

> Scaffold credit: Matt Pocock, wizard (mattpocock/skills). The composition and hard rules here are BACKS AIOS.