用途:管理 JIRA 问题之间的关系,包括链接、阻塞与依赖分析。必须使用 jira-as CLI,不要直接运行 Python 脚本。
主要能力:
- 链接类型:jira-as relationships link-types,可查看实例中配置的链接类型,支持 --filter 与 --output json。
- 创建链接:jira-as relationships link PROJ-1 --blocks PROJ-2,也支持 --is-blocked-by、--duplicates、--clones、--relates-to,或 --type "Blocks" --to PROJ-2;可用 --remote-url 添加指向任意 URL 的远程链接,配合 --remote-title、--remote-relationship。
- 查看与删除:jira-as relationships get-links PROJ-123,可按方向或类型过滤;jira-as relationships unlink PROJ-1 PROJ-2,支持 --dry-run 与 --type blocks --all。
- 阻塞与依赖分析:jira-as relationships get-blockers PROJ-123 --recursive,支持 --depth、--include-done、--direction;jira-as relationships get-dependencies PROJ-123,可用 -t 过滤类型。
- 统计:jira-as relationships stats PROJ-123 或 stats -p PROJ,支持 --jql、-t/--top、--max-results。
- 批量与克隆:jira-as relationships bulk-link --jql "..." --relates-to PROJ-500 --dry-run,支持 --issues、--skip-existing;jira-as relationships clone PROJ-123 --clone-subtasks -l,支持 -p、--summary、--no-link。
- 依赖图导出:get-dependencies 支持 --output mermaid、dot、plantuml、d2,可配合 dot、d2 命令渲染。
使用方式:需通过环境变量 JIRA_SITE_URL、JIRA_EMAIL、JIRA_API_TOKEN 配置凭据。多数命令支持 -o/--output,link 与 unlink 仅输出文本。退出码 0 成功,1 表示校验、API 或问题不存在等错误。
适用场景:冲刺规划中的阻塞链排查、跨项目依赖梳理、链接统计与孤儿问题发现、批量建立关联、克隆问题并保留关系、生成文档用依赖图。
限制:问题链接只是标签,不强制工作流规则;远程链接不能被阻塞或依赖分析遍历;链接类型名称可能区分大小写;创建链接需相应权限;批量操作可能超时,建议分批或限制结果;克隆可能受字段限制;循环依赖会被检测并报告。
资料未提供具体收费、价格与平台支持信息。