plan-epic 是一个用于为应用定义 GitHub 里程碑(Epic)的交互式规划流程,主要负责规划 Epic 本身,不负责创建具体故事(story 由 /plan-issue 处理)。
用途与原则:每次会话只规划一个 Epic,先取得操作员确认再继续;Shell 永远排在第一位;创建里程碑前必须先对话;每个后续 Epic 都应让用户获得可交互、可反馈的新内容。
主要流程:
- 读取仓库:查看 README.md、CLAUDE.md、AGENTS.md、package.json 或等价构建文件、顶层目录结构;寻找 prototype、design、mockups、wireframes 等原型目录并阅读其中说明屏幕、流程或功能的文件;运行 gh milestone list --state all 查看已有史诗,并请操作员确认理解。
- 确定下一个 Epic:若无里程碑则进入 Shell;若已有 Shell 则规划下一个 Epic。
Shell Epic:目标是产出一个可部署产物并配好完整 CI,但无领域功能。故事固定、不由操作员定义,包括 Repo Scaffold、Health Endpoint and Containerization、Unit Test Capability、Build and Publish Artifact、Security and Dependency Scan、Lint and Format Enforcement。确认后执行:gh milestone create "Shell" --description "Deployable shell app with full CI pipeline. No domain functionality."
后续 Epic:通过对话收集操作员希望交付的交互,例如能调用某接口、打开某页面、提交某表单等;若回答含糊需追问如何验证、在浏览器还是终端验证、需要哪些数据。有原型时可用 2–3 个具体屏幕聚焦讨论,但原型只是参考,不是按序执行的需求清单。达成一致后命名并创建里程碑:gh milestone create "[Epic Name]" --description "[一句话总结用户能做什么]"。
收尾时询问是否继续规划下一个 Epic;若否,列出本次创建的里程碑。若仓库不明确(多个远程或不在 git 仓库内),创建前先与操作员确认。
限制:资料未提供安装方式、收费信息、支持平台或效果保证;所有操作依赖 gh CLI 环境。