用途:该技能用于以 GitHub Issues 为核心规划与跟踪工作,把所有内容、层级、状态与历史都放在 Issues 中;Projects v2 仅作为可选的跨仓库可视化层,不存放内容与历史。
主要能力:支持子议题形成父子层级(每父级最多 100 个,可嵌套至 8 层),父议题显示完成进度;用标签表达状态与分类,如 status:、priority:、research:、type:,并用 gh issue list 过滤。提供 issue-分支-PR 生命周期:用 gh issue develop <N> --checkout 从议题创建分支,PR 正文写 Closes #N、Fixes #N 或 Resolves #N,合并时自动关闭议题;跨仓库写 Closes owner/repo#N。可选用 Projects v2 做看板、路线图与干系人状态更新,并通过标签约或配置文件自动关联议题。
必要用法:常用命令包括 gh issue create、gh issue view、gh issue list、gh issue edit、gh issue close,以及 gh project list/create/view/item-add。Projects v2 API 需要带 project 权限的 Classic PAT(ghp_),细粒度 PAT(github_pat_)不支持。引用议题时避免裸 #N 自动链接,改用完整 URL 或反引号 #1。
适用场景:单仓库少量议题、研究拆分、史诗分解、多步排查与分阶段工作;多仓库看板与干系人汇报可叠加 Projects v2。
限制:子议题仅限同一仓库;简易清单建议用 Markdown 复选框;Projects v2 无编辑历史、不存内容。资料未提供收费、价格或平台信息。