CTA 格式
每个 /dr-* 命令和流水线代理的规范 CTA“下一步”块格式。唯一事实来源——在生成斜杠命令输出时加载。
概述
CTA 格式是规范说明,用于定义每个 /dr-* 命令响应末尾发出的“下一步”行动号召块。它于 v1.16.0(<TASK-ID>)引入,解决了用户同时处理多个并行任务时下一步路由含糊不清的问题:现在每个 CTA 都包含解析后的任务 ID、恰好一个明确的主标记,以及一个可选的其它活跃任务菜单。
为什么存在
在 v1.16.0 之前,每个 /dr-* 命令都会发出自由格式的散文,例如“→ /dr-prd для <TASK-ID> (Research & PRD), или /dr-plan если хотите сразу перейти к планированию…”——用户必须在脑中把任务 ID 映射到命令,且没有明确的主推荐。对 15 个命令的审计显示,0/15 在其 CTA 中包含任务 ID,0/15 标记了主要操作。修复方案:由每个命令在每种情况下发出一个结构化、可预测的块。
规范块——单个活跃任务
---
**Следующий шаг — <TASK-ID>** (L3, in_progress)
1. `/dr-design <TASK-ID>` — **рекомендуется** — auto-transition после plan
2. `/dr-do <TASK-ID>` — если creative-phase не нужен
3. `/dr-status` — backlog overview
---
多任务变体(变体 B)
当 activeContext.md 中有多个活跃任务时,该块会追加一个 “Другие активные задачи” 部分,列出每个并行任务及其各自推荐的下一步命令。这是用户在跨项目处理 5-10 个任务时的发现入口。
FAIL 路由变体
当 /dr-qa 返回 BLOCKED 或 /dr-compliance 返回 NON-COMPLIANT 时,标题变为 **QA failed для {ID} — failed layers: <list of all failed layers> (total findings: N)**(或合规等价形式,总发现数为 M),并且主 CTA 指向返回命令,携带完整的 Consolidated Remediation Batch([QA-BATCH-1..N] / [COMP-BATCH-1..M]),以便在一次返工迭代中修复 100% 的差异。
设计约束(研究驱动)
- 3 个选项为最佳点,最多 5 个——Miller 定律、Hick 定律、Chernev 2015 关于选择过载的元分析
- 使用 Markdown
---水平线,绝不使用制表符─——Claude Code 问题 #34247:U+2500 在 Windows 上会导致乱码 - 标题使用内联粗体,绝不使用
##——Claude Code 的 GFM 渲染器会将所有标题级别折叠为粗体,无法区分层级 - 俄语外壳,英语命令——与现有框架中斜杠命令名称的约定一致
加载方
强制加载:planner、architect、developer、reviewer、compliance。由 /dr-* 命令文件引用。
测试方
tests/cta-format.bats——39 个规范回归测试,覆盖技能结构、命令引用、代理加载、路由技能对齐以及反模式防护(命令中无制表符,每个夹具恰好一个主标记)。
来源
<TASK-ID>,v1.16.0,2026-04-25。PRD:datarim/prd/PRD-<TASK-ID>.md。研究:datarim/insights/INSIGHTS-<TASK-ID>.md。
4.2 中的报告连接
共享的 Human Outcome Reporting 契约将任务需求连接到计划、结果、验证和证据。/dr-explain 是只读解释路径。发布模板和图使这些链接可被发现;项目脚手架现在使用 AGENTS.md 模板。