用途
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 配置。
- 部分步骤依赖特定引用文件与模板的存在。
- 具体收费、价格、平台支持范围等事实暂未提供。