用途:把已有的计划、规格或对话内容,拆解为一组“曳光弹”工单。每个工单是一条贯穿各层(schema、API、UI、测试)的纵向完整路径,可独立演示或验证,并声明阻塞它的其他工单;这些阻塞边决定实际执行顺序。
主要能力:可读取对话上下文,并在用户传入规格路径、issue 编号或 URL 时获取其完整正文与评论;可先探索代码库,使用项目词汇与相关 ADR,必要时先做预重构;按纵向切片拆分,宽泛重构则按“扩展—收缩”排序。
使用方式:先确定追踪方式——读取仓库 engineer 技能旁的 TRACKER.md,获知追踪器、命令与标签映射;若没有,则依据用户输入、git remote 和已认证 CLI 推断,无法推断时默认使用本地 Markdown 文件目录。可用 glob 查找:ls /skills/-engineer/TRACKER.md ./skills/-engineer/TRACKER.md 2>/dev/null。随后向用户逐条确认切分粒度与阻塞关系,经批准后按依赖顺序发布:本地文件写为每工单一个文件,默认 .scratch/<feature-slug>/issues/<NN>-<slug>.md,并在 <dir>/issues.md 写一份清单作为单一入口;真实追踪器则每工单建一个 issue,先发布阻塞项,使用平台原生阻塞关系或填写“Blocked by”,并按 TRACKER.md 指定的标签标注 agent 可领取的工作。最后向用户说明入口,例如 run /epic-runner .scratch/csv-export/issues/issues.md。
适用场景:需要将计划转成可被 epic-runner 等编排器逐张执行的工单集,并希望明确依赖顺序时。
限制:不关闭或修改任何父 issue;工单标题与描述避免具体文件路径和代码片段,仅当原型片段比文字更能精确表达决策时才内联并注明;宽泛重构不适用纵向切片。具体追踪器命令与标签字符串依赖 TRACKER.md 或运行环境,资料未提供固定值。