SuperAPI AI 工具集

rhdh-jira-link

通用与其它

查看项目

更新于 10-16 03:08

技能介绍

用途:把 GitHub Pull Request 或 GitLab Merge Request 与 RHDH 项目的 Jira 问题(RHIDP、RHDHPLAN、RHDHBUGS、RHDHSUPP)关联,附加标题形如 repo #N:… 的 Jira Web 链接。脚本位于技能根目录的 scripts/ 下,用 node 运行。

主要能力:

  • create-pr-mr.js:一次性创建 PR/MR。从 origin 自动识别 GitHub 或 GitLab,调用 gh pr create 或 glab mr create,随后执行 link-pr-mr.js 链接(除非 --no-link),并打开 diff 页(除非 --no-open)。支持标志:--draft、--no-push、--no-link、--no-open、--no-defaults、--no-comment、--no-jira-ref、--host github|gitlab。body 缺失时会追加 Ref: https://redhat.atlassian.net/browse/KEY 与 Generated-by: cursor;community-plugins 远程仓库跳过 Ref 行。
  • link-pr-mr.js link:对已存在的 PR/MR 附加 Jira Web 链接、评论并按需填充默认字段;--no-defaults 跳过 In Progress 与元数据填充,--no-comment 跳过评论;已有评论提及该 URL 时原地更新。
  • mark-merged:根据状态给 Web 链接标题加前缀 [x] merged: 或 [!] closed:,不重新应用默认值或评论;检查失败输出 warn 并保留在 leftOpen。
  • RHDHPLAN 中 Epic、Story、Task 类型关联后会自动迁移到 RHIDP。

认证:可用 JIRA_API_TOKEN 加 ~/.config/.jira/.config.yml 中的 login/server,或 acli 旁的 .jira-token(email:token)。认证可参考 /rhdh-jira-api。

默认字段:分派、团队、看板、故事点、优先级、团队/冲刺字段等需配置 ~/.config/rhdh-jira-link/config.json(也可用 $JIRA_PR_MR_CONFIG 或 config.local.json)。无内置团队/分派值,缺失配置会报错,但加 --no-defaults 时 Web 链接与评论仍可成功。

限制:每次运行都会产生外部写入(创建 PR/MR、写 Jira Web 链接、评论、迁移问题、填字段),首次命令前需调用 /mutation-gate 并获取一次性批准。与 /rhdh-pr-create 分工:后者负责 rhdh-plugins / community-plugins 单仓 PR 流程,本技能负责任意仓库的 Jira 链接与评论。