SuperAPI AI 工具集

wtf.epic-to-features

智能体与模型

查看项目

更新于 10-16 02:03

技能介绍

wtf.epic-to-features 是 xiduzo/wtf 技能集中的一个技能,用于把一个 Epic(史诗)一次性拆解为完整的 Feature(功能)集合。

用途

该技能在用户希望将 Epic 分解为完整功能集时使用,通常在 write-epic 之后自动触发。

主要能力

  • 将 Epic 的目标、背景与成功指标转化为候选 Feature 清单,每个 Feature 遵循“[领域角色] can [领域动词] [领域对象]”的模式。
  • 支持两种推进模式:guided 模式逐个编写每个 Feature 并由用户全程控制;flow 模式并行草拟整套 Feature 并统一审查一次。
  • 支持功能范围($WTF_SCOPE)为 single-story(更多更小的 Feature,每个仅承载一个用户故事)或 grouped(更少的 Feature,每个承载共享同一 Spine 的关联故事)。
  • 识别已有 Feature(通过 gh sub-issue list 查询),避免重复提议或重复创建。
  • 在 flow 模式下通过子代理并行草拟,收集 NEEDS_INPUT 升级项统一处理,再做合并审查与批量创建和依赖链接。

使用方式

  1. GitHub CLI 环境检查:运行 ../references/gh-setup.md 中的检查,若 gh 未安装或未认证则停止;若本次会话已确认 gh-setup 则跳过。 0b. 解析规划模式与功能范围:运行 ../references/planning-mode.md 中的 Resolve the mode 块;显式 guided 或 flow 参数优先于配置,$WTF_PLAN 决定走步骤 3(guided)或步骤 3F(flow)。随后按 wtf.write-feature 步骤 0b 解析 $WTF_SCOPE(读取 .wtf/config.json 中的 feature_scope 键,缺失则询问一次)。
  2. 识别 Epic:若已传入 Epic 编号则直接使用,否则通过 AskUserQuestion 询问;用 gh issue view <epic_number> 获取 Epic 并提取 Goal、Context、Success Metrics;用 gh sub-issue list <epic_number> 列出已创建的 Feature。
  3. 提出完整 Feature 清单:从 Epic 的 Goal、Context、Success Metrics 推导候选 Feature;由 $WTF_SCOPE 决定清单形态;以纯文本编号列表呈现,并用 AskUserQuestion 询问“Does this list look complete?”,等待用户确认或调整。该确认门在两种模式下都会执行。
  4. 逐个处理 Feature(guided 模式):每个 Feature 依次播报进度,遵循 wtf.write-feature 流程(跳过部分已完成的步骤,保留用户故事推导与 DDD Language Guard),并在继续下一个前用 AskUserQuestion 询问是否继续、暂停、跳过或新增功能。 3F. 并行草拟全部 Feature,统一审查一次(flow 模式):不创建任何内容直到用户批准。先读取 skills/wtf.write-feature/SKILL.md 并提取步骤 3–9,为每个已确认 Feature 生成一个子代理(单条消息内并行);子代理只草拟文本,绝不创建 issue、写文件,gh 仅限只读查询。随后解决升级项(NEEDS_INPUT 分组后一轮 AskUserQuestion 处理)、合并审查(每个 Feature 一块,含 Stories、ACs、Edge cases、Trace Plan、Depends on,并标注自动豁免或修正项),再用 AskUserQuestion 询问“Create all of them?”,选项为 Create all、Edit first、Drop some。审批后按依赖顺序批量创建并链接,复用一次 Haiku 子代理调用生成全部标题,创建依赖链接,并整体运行一次 wiki / 词汇表更新。若创建或链接失败,先完成其余部分再报告失败及重试命令。
  5. 完成:所有 Feature 创建或跳过后打印汇总(已创建、已跳过),并用 AskUserQuestion 询问下一步(规划首个 Feature 的 Traces、规划另一个 Feature 的 Traces、或到此停止),建议在继续前使用 /clear。

适用场景

已在 wtf 工作流中编写好 Epic、需要进一步拆解为 Feature 的规划阶段。

限制

  • 需要 GitHub CLI(gh)已安装并认证,否则在步骤 0 停止。
  • 依赖多个内部参考文件与 wtf.write-feature 流程;具体配置键、子代理协议等细节未在本资料中完整展开。
  • 资料未提供收费、价格、平台等其它信息。