技能介绍

解决的问题

在 DevOps 日常工作中，Jira 工单的查询、流转与批量操作往往依赖 Web UI，需要频繁切换上下文、手工点击或维护复杂的 JQL 脚本。当流程被自动化（如 CI/CD、缺陷分诊、值班机器人）触发时，开发者更需要一个稳定、可脚本化的接口来读取和操作 Jira，而不是打开浏览器。本技能的目标就是把 Jira REST API 收敛到一个自包含的 Python CLI 中，让工单操作能直接嵌入自动化流水线或终端工作流。

核心能力与工作方式

该技能的核心是 scripts/jira_cli.py，一个无需额外框架的 Python CLI，统一封装了 Jira 的 REST 接口。支持 Jira Cloud 与 Server/Data Center，所有命令输出 JSON 到 stdout，失败时返回非零退出码，便于被脚本或 Agent 调用。

典型能力包括：

查询与搜索：按 key 查看单条工单（如 show JIRA-123），或执行任意 JQL 查询（如“分配给我的未关闭 bug”）。
创建与更新：在指定项目创建 issue、添加评论、修改经办人。
流程流转：通过先调用 list-transitions 获取当前状态可用的目标流转名称，再执行 transition，避免直接猜测合法的 transition id。

配置方面，脚本从环境变量或 ~/.devops-skills/jira.json 读取连接信息，禁止在命令行中传递 token，降低凭据泄露风险。Cloud 使用邮箱 + API token（JIRA_AUTH=basic），Server/DC 个人访问令牌使用 JIRA_AUTH=bearer。

适用边界与注意点

该技能适配 Jira Cloud，以及 Server/Data Center 7.0 及以上版本。脚本在执行命令前会通过 /rest/api/2/serverInfo 检测服务端版本；若低于 7.0，会直接退出并提示兼容性问题。仅在明确需要绕过该保护时，才可设置 JIRA_SKIP_VERSION_CHECK=1 或 DEVOPS_SKILLS_SKIP_VERSION_CHECK=1。

需注意，assign 操作的 --user 参数在 Server 上使用用户名，在 Cloud 上可能需要 accountId。另外，该 CLI 只解决 Jira API 层面的调用问题，不涉及工作流设计、权限规划或自动化方案选型；遇到这类问题时，需结合具体项目环境进一步排查。