2026年7月20日

cta-format 技能 — 每次只有一个主要操作

cta-format 技能如何在每个流水线命令末尾强制使用结构化的“Next Step”区块,消除将任务 ID 映射到下一步操作的心智负担。

每个 /dr-* 命令都以同一个问题结尾:接下来我该运行什么?如果没有固定格式,答案每次都会不一样——有时是散文,有时是项目符号列表,有时什么都没有。cta-format 技能为该答案定义了一种规范形态,并要求每个流水线命令都使用它。

该区块的样子

输出是一个编号列表,包裹在两条 Markdown 水平规则之间。其中一条带有 рекомендуется 标记——恰好一条,从不为零,也从不为两条。每条都指明一个具体命令,并内联任务 ID,因此操作员可以直接将其复制粘贴到终端中。每个响应第一行的 Stage Header 告诉操作员该输出属于哪个任务,因为 40 多个并发任务会让上下文在没有它时变得模糊。

该格式有三种变体。标准变体处理单个活动任务。当多个任务处于活动状态时,第二部分会列出每个任务的推荐下一条命令。当 QA 或合规检查失败时,失败路由变体会更改头部,以指明最早失败的层,并指回正确的命令来修复它。

为什么上限是五个选项

编号选项的硬性上限是五个。其理由引用了 Miller's Law、Hick's Law 和 Chernev (2015)——选择的认知成本会随着选项数量增加而上升。该技能中确定的最佳点是三个选项。超过五个的任何情况都会因选择瘫痪而被排除。

主要标记解决了另一个相关问题。并行运行多个任务的操作员不应为了找到推荐路径而重新阅读整个区块。加粗标记使其能在一秒内被扫读。

失败路由

当 /dr-qa 返回 BLOCKED 或 /dr-compliance 返回 NON-COMPLIANT 时,区块会改变形态。头部会指明最早失败的层——Layer 1 (PRD)、Layer 3 (Plan)、Layer 4 (Code) 等等——并且主要选项会指向相应的修复命令。层到命令的映射在该技能中是固定的,因此无论哪个 agent 发出该区块,路由都是确定性的。

一个特殊的 Expectations-BLOCKED 变体会在主要选项中内联携带 --focus-items 参数。该参数只列出失败的 wish ID,因此开发者可以重新进入 /dr-do,精确针对这些条目,而无需重新运行完整实现。

快照生成

在 CTA 区块出现后,每个 /dr-* 命令都会通过运行时解析的包装脚本,将最终操作员可见的响应持久化到 datarim/snapshots/{TASK-ID}.snapshot.md。在终端关闭或 /clear 之后,该快照会作为 /dr-next 的主要上下文——该命令会先读取快照,然后再回退到任务描述文件。

一个可选的 Claude Code Stop hook 会在每个响应上强制执行 Stage Header:首次出现缺少头部时会阻止输出;第二次缺失则降级为 stderr 提示。该 hook 为可选启用,并记录在 documentation/how-to/dr-output-hook.md 中。

阅读 Datarim 是什么 以了解完整流水线图景,或查看 /dr-next 命令 了解恢复时如何使用快照。