用途:为多阶段功能开发提供流程参考,使用 git worktree、GitHub 主问题(epic)与子问题、分阶段 PR 交付。
主要能力:判断阶段划分,一个阶段等于一个可独立评审和测试的 PR(约一个子系统、一次迁移,或最多约 500 行非生成代码变更);描述包含 2 个及以上此类单元则视为 epic,恰好一个则走单阶段快捷流程;每个阶段需有可测试的完成定义,若两个候选阶段只能一起测试则合并为一个。派生 slug 时取阶段标题,去掉停用词,保留 2-3 个词,宾语名词在前,用 kebab-case(如 backend-metrics、sync-engine)。
用法:分支策略上,若存在 develop 分支则以其为集成分支,否则用默认分支。epic 分支命名 feature/issue-{N}-epic-{short-name},从集成分支创建;阶段分支命名 feature/issue-{N}-phase{X}-{short-name},从 epic 分支创建,以 squash 合并回 epic 分支;最终 epic 到集成分支用普通合并保留历史。状态文件存于 .claude/epic.local.md,记录 epic 问题、集成分支、epic 分支、worktree 基路径、各阶段编号、标题、问题号、分支、状态和 PR 号。worktree 操作使用绝对路径,创建与清理命令包括 git worktree add、git worktree remove、git branch -d。GitHub 操作用 gh 命令创建问题和 PR,例如 gh issue create --title "Epic: {description}" --label "feature"、gh sub-issue add、gh pr create --base {epic_branch}、gh pr merge --squash --delete-branch。
适用场景:多阶段功能开发、分阶段评审交付、需要隔离 worktree 并行实现、按阶段跟踪状态。
限制:缺失信息暂未提供。
适用性:还需平台支持技能调用机制、GitHub CLI、git worktree 等前提。