用途
本技能面向 GitHub CLI(gh)的系统化使用,目标是让开发者以命令行完成议题、拉取请求、Projects v2 项目板与自动化操作,并遵循较新的分支和 PR 约定。资料将该技能定位为“掌握 gh 进行完整项目管理”,覆盖议题创建、PR 工作流、Projects v2 集成和自动化模式。
主要能力
- 议题操作:创建议题,指定标题、正文、标签和里程碑;按状态、标签、负责人筛选并列出议题;编辑标签与里程碑;关闭议题时附带评论。
- PR 操作:创建 PR 并指定基础分支和评审人;实时查看 CI 检查状态;以 squash 方式合并并删除分支;在 CI 通过且获批后自动合并;提交批准评审。
- Projects v2:列出项目,将议题以 URL 形式加入项目,列出项目字段;设置自定义字段(如状态)需通过 GraphQL mutation 完成。
- API 操作:使用 gh api 调用 REST 接口,用 --jq 过滤输出;执行 GraphQL 查询;以 POST 方式触发仓库 dispatch 事件。
- JSON 输出与 jq 模式:按标签筛选议题编号;汇总 PR 的检查状态;按作者统计 PR 数量;筛选长时间无活动的议题。
使用方式
资料给出一套工作流模板:先创建议题并提取编号,再基于 main 拉取最新代码并创建特性分支,提交时采用约定式提交(type(#issue): description),推送后创建 PR 并关联议题(如 Closes #123)。分支命名建议包括 issue/<编号>-<描述>、feature/<描述>、fix/<编号>-<描述>、hotfix/<描述>。多行正文建议用 heredoc 传入;用于脚本时优先使用 --json 配合 --jq 解析;批量操作前可先检查速率限制(gh api rate_limit)。自动化场景应使用非交互参数(--title、--body 等),避免直接向 dev/main 提交。
适用场景
适合以 GitHub 为协作平台的团队在命令行内管理议题和 PR、维护项目板状态、编写批量脚本与查询复杂数据,也适合建立统一的提交信息、分支命名和标签/里程碑规范。资料中的标签(优先级、领域、类型)与里程碑表是示例 SaaS 应用的配置参考,可按实际项目调整。
限制与说明
资料未提供该技能的安装方式、运行环境要求、收费或授权信息,也未说明其与具体 AI 客户端的集成方式,这些内容暂未提供。Projects v2 自定义字段需通过 GraphQL 设置;示例中的项目 ID、字段 ID 等占位值需替换为实际值。资料中的日期、版本号和里程碑时间均为示例,不代表产品承诺。