SuperAPI AI 工具集

jira-cli

通用与其它

查看项目

更新于 10-16 00:03

技能介绍

用途:在终端中与 Atlassian Jira Cloud 交互,基于 Jira REST API v3,完成搜索工单、查看详情、创建工单、添加评论、列出项目和流转状态等操作。

主要能力:me 查看当前用户资料;list 搜索工单,支持 --project 快捷过滤和 --jql 自定义 JQL;view 查看工单详情(摘要、类型、状态、优先级、经办人、报告人、时间戳及从 ADF 提取的纯文本描述);projects 列出可访问项目;create 创建工单,可指定 --type、--priority;comment 添加评论;transition 按名称或 ID 变更状态,无效时列出可用选项。

使用方式:先在 id.atlassian.com/manage/api-tokens 生成 API Token,再设置环境变量:export JIRA_EMAIL="your-email@example.com"、export JIRA_API_TOKEN="your-api-token"、export JIRA_SERVER="https://your-domain.atlassian.net"。--help 与 --dry-run 无需凭据即可使用。全局参数 --json、--dry-run、--quiet 可放在子命令前后任意位置。

适用场景:需要在脚本或终端中批量查询、创建、评论和流转 Jira 工单的开发者与运维人员。

限制:认证使用邮箱加 API Token 的 HTTP Basic Auth,邮箱须为 Atlassian 账户邮箱而非用户名;描述与评论使用 ADF 格式,创建富文本需通过 --description 传入 ADF JSON;可用流转取决于工单当前状态与项目工作流;Jira Cloud 有速率限制,超限返回 429 且 CLI 不自动重试;项目键在某些场景区分大小写。