用途
wtf.write-epic 用于在用户想要创建、起草或规划一个 GitHub Epic 议题时使用，例如“write an epic”“I want to define a new initiative”。它帮助把一个战略举措整理成结构化的 Epic 议题，涵盖干系人、目标、成功指标和功能拆解框架。
主要能力
- 捕获种子想法：通过 AskUserQuestion 询问用户正在推进的举措，可从近期开放的 Epic 或 README 上下文中推断候选。
- 深度研究：并行使用 Agent 工具与 GitHub 议题搜索，探索代码库（README、docs、ADR、模块结构、领域名词、术语表、.github 文档），获取 GitHub wiki 或仓库内术语表，并查找相关议题。
- 追问补全：针对范围边界、成功标准、干系人、约束或截止日期、风险与依赖、Bounded Context、Ubiquitous Language 等未答项进行定向提问。
- DDD 语言检查：确保 Epic 标题描述业务成果而非技术动作，目标使用领域词汇，将技术术语重构为业务成果。
- 垂直切片评估：运行 scope-gates 第 1 阶段，判断该举措是否是可独立交付用户或业务价值的连贯战略举措。
- 起草 Epic：按 EPIC 模板填充各节，成功指标须具体可衡量，功能拆解保留为空占位符，并应用 STE 写作规范。
- 范围门禁：运行 scope-gates 第 2 阶段，识别目标捆绑、功能过多、跨多个 Bounded Context、成功指标分属不同用户旅程等拆分信号，并提出具体拆分方案。
- 用户评审与创建议题：展示草案，确认后通过 gh body helper 创建议题，标题由子代理生成，并分类为 Epic。
- 原生依赖链接：若 gh-issue-dependency 扩展可用，为每个依赖创建阻塞链接；不可用时警告用户，不将依赖引用写入议题正文。
- 更新 wiki / 术语表：若引入或细化了 Bounded Context 定义或 Ubiquitous Language 术语，更新或创建项目术语表，并维护可 grep 的 STE 允许列表表格。
- 提供后续选项：规划所有功能（wtf.epic-to-features）、撰写单个功能（wtf.write-feature）、撰写另一个 Epic 或停止。
使用方式
该技能以步骤流程方式运行：先执行 GitHub CLI 设置检查（若本会话已确认则跳过），然后捕获种子想法、深度研究、追问用户、DDD 语言检查、垂直切片评估、起草 Epic、范围门禁、用户评审、创建议题、更新术语表，最后询问下一步。创建议题时，正文先写入临时文件，再通过 python3 .wtf/gh-body.py create --title "🎯 Epic: <title>" --body-file "$BODY" 创建，随后分类为 Epic。依赖链接使用 gh issue-dependency add <this_epic_number> --blocked-by <blocker_number>。
适用场景
适用于需要定义新战略举措、规划 Epic 议题、整理干系人与成功指标、进行领域语言规范化，以及为后续功能拆解做准备的团队工作流。
限制
若 gh 未安装或未认证，流程会停止。若 GitHub 不可用，相关议题搜索子步骤会被跳过。原生依赖链接依赖 gh-issue-dependency 扩展是否可用。技能依赖多个引用文件（如 ../references/gh-setup.md、questioning-style.md、ddd-writing-rules.md、scope-gates.md、ste-writing.md、issue-template-loading.md、gh-body-helper.md、issue-classification.md），这些文件的具体内容暂未提供。