基础工具与工作流 · mattpocock/skills

wait-what

Stop. That last message did not land: re-pitch it.

L1 基础 · 登记来源即可V1 已固定Dual-pass Audit
Author mattpocockGitHub mattpocock/skills ↗Stars 253948License MIT(GitHub API spdx 标注;该 commit 的 checkout 树内未发现 LICENSE 文件,git ls-files 亦无)Commit 3cca18b368
管控等级描述 skill 的能力与建议配套的管控措施,不代表质量或安全认证,也不表示可用或不可用。是否使用由用户和管理者决定。不同 agent 宿主对权限的约束各不相同,请勿假定宿主一定会提供安全兜底。第三方 skill 版权归原作者,使用风险由使用者自行承担。

1实现原理 · 为什么它能做到

整份 skill 是纯 prompt 编排,无任何脚本/资产:正文只有一段祈使指令,让模型执行一次「沟通修复」——承认上一条消息没被理解、补充少量上下文后重讲。能生效完全靠模型对指令的语言学执行,而非代码逻辑。

productivity/wait-what/SKILL.md
Wait, I don't understand where you've got to here. Re-pitch that: give me a little bit of context, talk in ASD-STE100 Simplified Technical English, and use the ubiquitous language from `CONTEXT.md` (follow `CONTEXT-MAP.md` to the right one if the repo has more than one).
skill 目录仅 2 个文件共 552 字节(SKILL.md 394B + agents/openai.yaml 158B)。正文以用户第一人称困惑口吻起句,等于把「我卡住了」直接变成给模型的指令。

触发被显式限制为用户手动调用:Claude Code 侧 disable-model-invocation: true,OpenAI/Codex 侧 allow_implicit_invocation: false,模型不得自行触发;正文起始句的作用是规定「模型看到用户困惑时应做什么」,而不是让模型主动喊停。

productivity/wait-what/SKILL.md
disable-model-invocation: true
productivity/README.md 对应注明 User-invoked:「Reachable only when you type them (Claude Code: `disable-model-invocation: true`; Codex: `policy.allow_implicit_invocation: false` in `agents/openai.yaml`)」,与两文件元数据互相印证。

措辞靠双重语言约束实现:STE100 Simplified Technical English(受控技术英语,约束句法/词汇)压缩表达复杂度;CONTEXT.md 的 ubiquitous language 把术语钉死在仓库统一词汇上,多 context 仓库先经 CONTEXT-MAP.md 定位到正确的 CONTEXT.md。

productivity/wait-what/SKILL.md
talk in ASD-STE100 Simplified Technical English, and use the ubiquitous language from `CONTEXT.md` (follow `CONTEXT-MAP.md` to the right one if the repo has more than one)
STE100 规则不随附、无链接,依赖模型内置知识(仓库内唯一 STE100 提及即本 skill);CONTEXT.md 是用户仓库本地文件,由模型按指令读取。

CONTEXT.md/CONTEXT-MAP.md 约定不是 wait-what 自带的,而是 mattpocock 多 skill 共享生态(本体定义在 engineering/domain-modeling/CONTEXT-FORMAT.md:单 context 一个根 CONTEXT.md;多 context 由 CONTEXT-MAP.md 列出各 context 位置与关系;由 domain-modeling 等 skill 懒创建)。wait-what 是纯消费方。

engineering/domain-modeling/CONTEXT-FORMAT.md
If `CONTEXT-MAP.md` exists, read it to find contexts - If only a root `CONTEXT.md` exists, single context - If neither exists, create a root `CONTEXT.md` lazily when the first term is resolved
wait-what 正文里「follow CONTEXT-MAP.md to the right one」正是在复用这条解析规则,但 wait-what 自身未写明 CONTEXT.md 缺失时的降级行为。

作者在 ask-matt 中给出了生态定位:wait-what 是「事后矫正」(message 没落地的补救,会话中途任意 skill 内可用),与「事前预防」的 grill-with-docs(提前约定共享语言)互补。

engineering/ask-matt/SKILL.md
`/wait-what` is the corrective for a message that didn't land. Use it mid-conversation, inside any other skill, and the agent re-pitches what it just said with the context you were missing, in plain English, using the `CONTEXT.md` vocabulary. It works after the fact; `/grill-with-docs` is the upfront cure
来自仓库内另一 skill 的作者自述,与 wait-what 自身声明及 productivity/README 描述一致。

2核心能力

01重述上一条未被理解的消息(re-pitch),并主动补上用户缺失的上下文
02输出语言约束为 ASD-STE100 Simplified Technical English(受控技术英语)
03强制采用仓库 CONTEXT.md 的 ubiquitous language(统一术语);多 context 仓库经 CONTEXT-MAP.md 定向到正确的 CONTEXT.md
04仅用户显式调用:模型不可自动触发(Claude Code 元数据)
05跨宿主配置声明:为 Codex/OpenAI 系宿主提供 display_name 与 short_description,并同样禁隐式调用

4管控建议与判定依据

建议配套管控措施
面向 Agent
可自动加载
面向管理者
登记来源与版本
判定依据(文件路径与关键语句摘要)
  • SKILL.md: 纯提示词指令与规则文本,无脚本执行与外部影响
审计说明: 。纯指令 skill:无脚本执行、无网络外发、无凭证读取、无本地写入;全部行为是要求模型以受控措辞重述上一条消息(读取 CONTEXT.md 属宿主常规文件读取面)。唯一注意点:依赖模型对 STE100 的内置知识,执行严格度因模型而异。

5第二遍独立确认

  • [ok] 第一遍断言「无外部 CLI/API/网络/包依赖」 — 两文件逐字节重读:无 URL、无命令、无包引用、无 import;仓库级 grep 显示 STE100 全仓库唯一提及即本 skill,无配套规则文件
  • [ok] 第一遍断言「目录内无脚本/资产/隐藏文件」 — find 全目录仅 productivity/wait-what/SKILL.md 与 productivity/wait-what/agents/openai.yaml 两文件,无点文件
  • [ok] disable-model-invocation 语义=仅用户触发 — productivity/README.md 原文「Reachable only when you type them (Claude Code: `disable-model-invocation: true`; Codex: `policy.allow_implicit_invocation: false`)」与两文件元数据一致
  • [ok] CONTEXT.md/CONTEXT-MAP.md 约定来源(wait-what 自身不携带) — engineering/domain-modeling/CONTEXT-FORMAT.md 定义了单/多 context 布局与读取规则(含「create a root CONTEXT.md lazily」);setup-matt-pocock-skills/domain.md 也引用该约定;wait-what 目录内确无此类文件
  • [ok] 作者生态定位描述(ask-matt 提及 wait-what)与正文能力相符性 — ask-matt/SKILL.md 原文「re-pitches what it just said with the context you were missing, in plain English, using the CONTEXT.md vocabulary. It works after the fact」与 SKILL.md 正文指令一一对应,无夸大
  • [ok] 功能声明 vs 实现相符性 — description「Stop. That last message did not land: re-pitch it.」与正文一致;宣称的只是 prompt 能做的事,无吹牛
  • [ok] license 元数据 — GitHub API 返回 license.spdx_id=MIT;但本 commit checkout(git ls-files + find)无 LICENSE 文件——记录来源为 API,非树内文件
  • [ok] stars/last_push 元数据 — API 2026-09-06 采集:stargazers_count=253948,pushed_at=2026-09-04T08:45:43Z 与 HEAD 3cca18b(2026-09-04)一致

6结论

  • 极低摩擦的即时矫正:整份 skill 就是一段正文,用户任何时候说「没懂」即触发重讲
  • 术语纪律:强制回到 CONTEXT.md 的 ubiquitous language,避免重讲时仍飘在行话里
  • STE100 受控语言约束表达复杂度,重述倾向短句/简单词,利于走神或非母语场景
  • 安全边界清晰:无脚本/网络/凭证/写入,且两个宿主均禁模型自触发,只有用户显式调用
  • 生态定位明确:作者在 ask-matt 中给出与 grill-with-docs 的分工(事后矫正 vs 事前预防),可组合使用
  • 适合: 适合:与 agent 长会话中消息反复「没接住」时的即时矫正;配合已建立 CONTEXT.md 生态的仓库(domain-modeling/setup-matt-pocock-skills 初始化过)效果最佳;教不熟悉工程语境的人读懂 agent 输出也有用。
    不适合: 不适合:当独立任务型 skill 用(无产出物、无流程、无脚本);仓库既无 CONTEXT.md 又不打算先建统一术语的场景;需要可审计/合规级 STE100 文档的场合。
    Install Agent-Ready
    ① Verified Mirror 2026-09-06
    Option A · Direct DownloadDownload wait-what.tar.gz
    sha256: 7953c2143da38542…
    Option B · Copy Guide for Agent
    install.json
    agent 读 JSON 指南后会自动从本站下载安装,无需更多说明。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 3cca18b368.