SuperAPI AI 工具集

wtf.write-feature

编程与开发

查看项目

更新于 10-16 02:01

技能介绍

用途

wtf.write-feature 用于创建一个 GitHub Feature issue,该 issue 定义一个面向用户的能力(user-facing capability)。它会获取父级 Epic 作为上下文,使用户无需重复描述背景。该技能通常由 wtf.epic-to-features 或 wtf.write-epic 编排调用,也可独立使用。

主要能力

  • 解析规划模式(guided 或 flow)与特性范围(single-story 或 grouped)。
  • 识别父级 Epic,提取 Goal、Context 与 Success Metrics;若无 Epic 则标记为规划债务。
  • 按领域语言命名能力,格式为 [Domain Actor] can [domain verb] [domain object]。
  • 在继续前澄清歧义,问题分为必答项与上下文相关项两层。
  • 派生用户故事(As a _, I want _ so that ___)及其验收标准与 Gherkin 场景。
  • 执行 DDD 语言守卫,扫描并静默修正反模式。
  • 进行垂直切片评估,判断特性是否过宽或存在依赖。
  • 起草 Feature,包含 Bounded Context、Domain Events、Acceptance Criteria、Scenarios、Edge Cases、Delivery Override 等字段。
  • 提出 Trace Plan(有序清单,含 Skeleton、Extension、Deepening 条目)。
  • 运行 Definition of Ready 检查清单。
  • 运行范围门禁,识别拆分信号并给出拆分建议。
  • 与用户复核后,通过 GitHub CLI 创建 issue,并链接为父 Epic 的子 issue。

使用方式

技能通过一系列步骤执行,涉及多个引用文件(如 ../references/gh-setup.md、../references/planning-mode.md、../references/ddd-writing-rules.md、../references/scope-gates.md、../references/ste-writing.md、../references/issue-template-loading.md、../references/gh-body-helper.md、../references/issue-classification.md、../references/questioning-style.md、../references/spec-hierarchy.md)。

关键命令示例:

python3 .wtf/gh-body.py create --title "🚀 Feature: <title>" --body-file "$BODY"
gh sub-issue add <epic_number> <feature_number>

创建 issue 时先写入临时文件($BODY),再通过 gh body helper 创建,以支持多行 UTF-8 内容。标题由使用 claude-haiku-4-5-20251001 模型的子代理生成。

适用场景

  • 需要将 Epic 拆解为面向用户的能力。
  • 需要以领域驱动设计(DDD)语言编写用户故事。
  • 需要为 GitHub 项目创建结构化的 Feature issue 并链接到 Epic。
  • 需要生成 Trace Plan 作为后续 wtf.feature-to-traces 的起点。

限制

  • 依赖 GitHub CLI(gh)已安装并完成认证;若未满足则停止。
  • 依赖 .wtf/config.json 中的 feature_scope 配置。
  • 部分步骤依赖特定引用文件与模板的存在。
  • 具体收费、价格、平台支持范围等事实暂未提供。