SuperAPI AI 工具集

github-jira

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

该技能面向使用 JIRA Cloud 管理 Scrum、GitHub 管理代码与发布的项目,核心是用 JIRA 票据编号(<PROJECT_KEY>-NNN)串联分支、PR、发布和票据。

用途与能力:主工具为 jira CLI(ankitpokhrel 的 jira-cli),可完成票据查询、创建、分配、移动状态、评论等操作;CLI 未覆盖的冲刺、版本、特定转换可用 REST API v3 结合 curl 处理。启用 Atlassian 官方 JIRA+GitHub 集成后,创建含票据编号的分支会自动关联票据,含编号的 PR 会链接到票据,合并后(若配置)可将票据转为 Done。补充的自定义 Actions 包括:labeler.yml 依据分支前缀自动打 type:* 标签;jira-label-pr.yml 从分支读出票据并把 priority:* 与 size:* 映射到 PR;jira-release-sync.yml 在发布 Release 时于 JIRA 创建 Version 并关联票据。

使用方式:安装示例为 brew install jira-cli、scoop install jira-cli、snap install jira-cli,Linux 无 Snap 可从 GitHub Releases 下载二进制。初始化需先 export JIRA_API_TOKEN,再用 jira init 传 --installation cloud、--server、--login、--auth-type basic、--project、--board、--force。分支命名需包含大写票据编号,如 feature/<PROJECT_KEY>-123-short-description。仓库根可建 .jira.d/config.yml 覆盖全局默认,但用 jira issue create 创建票据时需显式传 --component。

适用场景:冲刺规划、执行、评审与回顾,跨多个 GitHub 仓库的单一 JIRA 项目,需要在 PR 上自动显示 JIRA 优先级与规模标签,以及 GitHub Release 与 JIRA Version 同步。

限制:官方集成需启用;GitHub Actions 需配置 JIRA_BASE_URL、JIRA_USER_EMAIL、JIRA_API_TOKEN、JIRA_CLIENT_ID、JIRA_CLIENT_SECRET、JIRA_CLOUD_ID 等密钥;--board 名称须与 JIRA 中完全一致;状态转换名取决于 JIRA 工作流配置。若同时用 github-scrum,二者后端不同但可共存。其余细节暂未提供。