用途:在 GitHub Projects(v2)上把仓库 issue 组织成以史诗(Epic)为骨架的路线图,并支持日常看板运营,包括项目初始化、字段与视图设置,以及创建带子 issue 的史诗、推进 Status、移动工作项和排优先级。核心基于 gh CLI 与 GraphQL,仅适用于 GitHub。
主要能力:史诗通过原生 parent/child 子 issue 链接嵌套,而非 markdown 勾选列表;看板 Status 通过项目字段显式设置或启用原生工作流自动推进;Type(Task/Bug/Feature)与 Milestone 属于 issue 元数据而非项目字段;支持在史诗之间通过重新指定父级来移动 issue;支持里程碑的创建、查找与关闭;并提供仓库与项目两级访问权限的授予方式。
使用方式:先创建项目、字段(Status、Priority)与标签(如 epic),视图与工作流开关需在 UI 一次性设置(无 API)。典型命令包括:gh project create --owner @me --title "Roadmap";gh issue edit <epic> --add-sub-issue <child>;gh issue edit <child> --parent <newEpic>;gh project item-edit <num> --owner @me --url <issue-url> --field Status --value "In Progress";gh issue edit <n> --type Bug --milestone "v1.0"。REST 与 GraphQL 的完整命令集见资料所列参考文件。
限制:仅支持 GitHub,Projects v2 无 GitLab 对应;需要 gh >= 2.94(--type、--milestone、--parent、--add-sub-issue)与 gh >= 2.97(按名称 item-edit),并需 project 权限范围,否则出现鉴权或权限错误;视图创建与工作流开关无 API,只能在 UI 操作;issue 类型仅在组织仓库可用;子 issue 变更每请求约 25 条批量上限,超限会部分失败,重跑安全;仓库角色与项目角色是两套门槛,仅设置其中一个会导致团队成员无法操作对应内容。其他具体事实暂未提供。