用途
该技能用于把一项手动操作整理成一条可以照着走完的编号步骤块(block),面向的是首次做某件事、但对该操作熟练者来说显而易见的人。例如创建 PAT、把域名指向某处、给 CI 配置 secret 等。这类用户不需要理论,只需要一份带完整取值、可点击链接的编号清单。
最终产出的是一条完整的交接消息,发送后即停止并等待,不继续推送下一步。
主要能力与写法要求
- 取值全部字面化:例如写
Token name: habits-context-sync,而不是“给它起个名字”。仓库、owner、secret 名称等应从环境中挖掘并填入,占位符等于把决策又丢回给求助者。 - 链接为完整 URL,尽量深:例如
https://github.com/settings/personal-access-tokens/new,而不是“进入 Settings → Developer settings”。页面若无稳定 URL,则从一个有稳定 URL 的页面给出点击路径。 - 在会咬人的那一步点名陷阱:例如“Resource owner 在下拉里选
Habits-Family,不要选个人账号”。选错可能很久以后才暴露。 - 说明会自动发生的事,避免用户被意料之外的字段卡住,例如“(Metadata: Read-only 会自动加上。)”
- 把分支并入所属步骤,不拆散列表,例如“如果显示 pending approval:自己在
<url>批准它。” - 最后一步是测试,并写明应看到的结果。
- 面向“屏幕”而非“系统”:用按钮上印着的原话称呼按钮。
使用方式(流程)
- 先做自己那一半:凡是从终端可达的事都先做完,剩下的才是需要浏览器、控制台或密码的部分。剩余部分也构成开场那句“现在有什么在空等”。完成标准:剩下的每一步都确实需要人来做。
- 拿到真实流程:点击路径取自一手来源(厂商当前文档或页面本身),第三方 UI 会被改名,凭记忆的路径会让人去找一个已不存在的按钮。取值取自环境:git remotes、
.env、.env.example、.github/workflows/*(每个secrets.*引用都对应一个需要产出的值)。无法确认当前 UI 时,说明这一点并询问用户看到什么。完成标准:每一步都有其 URL 与字面取值,且知道最终测试能证明什么。 - 先展示路线,再交接:约 30 步以内、一次完成,则只发一个块,其编号列表就是路线;超过约 30 步、中间有等待或需要多次完成,则先给路线(每部分一行),再单独发第 1 部分。长流程按“接缝”而非步数切分,每部分是一个完整任务,收尾在可检查的结果上(“token 已存在”“secret 已设置”“workflow 跑绿了”);在表单中途结束的切分即使正巧 30 步也是坏切分。每部分标题形如
Now you (2 of 4): wire the secret,步数重新从 1 编号。然后停止:一条消息只发一部分,下一部分等这部分落地后再发。 - 接收回报:无论返回的是完成、报错,还是与描述不符的界面,都要在进入下一部分前处理掉。界面不符意味着来源过期,需重新寻找当前路径。
- 证明它:凡是能触达的收尾检查都亲自跑一遍,让目标被展示出来而非假设成立。
关于密钥(Secrets)
密钥从展示它的页面直接流向消费它的字段。在块中:给它单独一步,写明确切目的地(密钥名称与设置 URL、.env 行、keychain 条目);在创建它的那一步写上“不要把它粘贴进这个聊天”,因为对话会成为记录,而记录不是密钥仓库;在产出处标注一次性值,例如“现在就复制,它只显示一次”。确认用户取到正确值的方式是检查属性(前缀、长度、末四位),绝不检查值本身。若某个值需要传给你运行的工具,使用不打印它的路径,如 gh secret set NAME 提示输入,或 read -s。若密钥仍然落进了聊天:直说,让其吊销并重新签发,用新值继续。