用途:编写 tracer-bullet card,为一条将以 /pragma:slice 实现的端到端薄切片工作提供精确规格说明。适用于划定新切片范围、定义下一步构建内容等场景。
输入与前置条件:输入为要交付的行为($ARGUMENTS)。前置条件是必须已存在 concept capsule;若不存在,应停止并建议先执行 /pragma:capsule。需读取该 capsule,卡片必须使用其中的术语表(glossary)词汇并遵守其不变量(invariants)。
输出:卡片必须恰好包含四个字段。Target Behavior:一句话、可观察/可测试、引用 capsule 术语,若需要“and”则拆成两张卡片。Boundary Crossings:列出曳光弹经过的每个边界,从入口点、各层/边界到出口点,需具体说明(如“the PostgreSQL adapter”),并标注尚不存在的边界。Risks / Assumptions:包含 RISK 与 MITIGATION、ASSUMPTION 与 VALIDATED BY、必填的 BUY-OR-BUILD、行为不清晰时必填的 PROTOTYPE PLAN,以及至少一条 OUT OF SCOPE;“无风险”通常是错的;高风险且未缓解时应先做 /pragma:spike 而非 /pragma:slice。Definition of Done:以 ✓ 测试名 — 可观察断言的形式列出,断言须可执行,优先黑盒断言,不包含“代码整洁”之类内容。Validation:确认目标行为是否一句话、术语使用是否正确、每个风险是否已缓解或标记为 spike、buy-vs-build 是否明确、行为不清晰时是否有原型计划、DoD 是否映射到具体测试名与可观察检查、能否通过运行命令检查、切片能否在一次专注会话中实现。
放置位置:卡片是临时的,由 /pragma:slice 消费后其 Definition of Done 成为测试。默认打印到对话;若用户希望跟踪,可写入 docs/cards/。
生命周期结尾(必需):追加 State: planning、Next: /pragma:slice、Loop: /pragma:consult(默认,除非用户明确直接继续)。
限制:资料未提供该技能的收费、价格、平台等更多信息;其流程依赖 capsule 与 /pragma 系列命令。