Jira Skills

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install jira-devops-skill
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 jira-devops-skill。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Jira Skills 提供一个统一的 Python 命令行界面，用于访问 Jira REST API，让 AI 编码代理无需离开终端即可处理 Jira 问题。可用它检索工单、运行 JQL 搜索、创建缺陷或任务、添加评论、指派用户，以及在工作流中推进问题。
该技能支持 Jira Cloud 和 Jira Server 或 Data Center 7.0+，并将命令结果以 JSON 格式输出到 stdout。Openclaw Skills 用户可将 Jira 问题管理集成到开发工作流中，同时将凭据保存在环境变量或本地配置文件中，而不是命令行参数中。

应用场景

检索问题，以查看其当前状态、详细信息或其他可用字段。
使用 JQL 搜索 Jira，例如查找已指派但未解决的缺陷，或按项目和状态筛选。
创建包含项目、问题类型、摘要和描述的缺陷或任务。
为问题添加评论或将其指派给用户。
查看可用的工作流转换，并将问题推进到有效的目标状态。
通过 AI 代理自动执行 Jira 任务，同时对会修改问题的操作保留确认步骤。

工作原理

使用环境变量或 ~/ .devops-skills/jira.json 配置 Jira URL 和身份验证详细信息。
使用相关子命令运行 scripts/jira_cli.py，例如 get-issue、search、create-issue、comment、assign 或 list-transitions。
CLI 通过 REST API 连接 Jira。执行命令前，它会检查 /rest/api/2/serverInfo，以确认 Jira 版本兼容性。
更新工作流时，先运行 list-transitions 获取有效的转换目标，再将有效目标传递给 transition。
从 stdout 读取 JSON 结果。若命令失败，CLI 将以非零状态退出。
执行创建、评论、指派或转换问题等写入操作前，先与用户确认问题键和目标值。

配置指南

在环境中设置 Jira 连接详细信息，或配置 ~/ .devops-skills/jira.json。不要将令牌直接放入命令行参数。
export JIRA_URL="https://your-domain.atlassian.net"
export JIRA_USER="you@example.com"
export JIRA_TOKEN=""
export JIRA_AUTH="basic"
对于 Jira Cloud，使用电子邮件地址和 API token，并设置 JIRA_AUTH=basic。对于 Jira Server 或 Data Center，使用 Personal Access Token，并设置 JIRA_AUTH=bearer；用户名可以省略。
使用安装了 requests 依赖的 Python 环境运行 CLI。该技能建议在可用时使用绝对路径调用受管理的 Python 解释器：
PY=~/ .workbuddy/binaries/python/envs/default/bin/python
$PY scripts/jira_cli.py get-issue PROJ-123
如果缺少 requests，请在同一解释器中安装：
$PY -m pip install requests -i https://mirrors.aliyun.com/pypi/simple/
示例命令：
$PY scripts/jira_cli.py search "project = PROJ AND status = 'In Progress'" --limit 20
$PY scripts/jira_cli.py create-issue --project PROJ --type Bug --summary "Login fails" --description "Steps..."
$PY scripts/jira_cli.py comment PROJ-123 --body "Looking into this"
$PY scripts/jira_cli.py list-transitions PROJ-123
$PY scripts/jira_cli.py transition PROJ-123 --to "Done"
$PY scripts/jira_cli.py assign PROJ-123 --user jdoe
完整配置选项、字段详细信息和故障排除方法，请参阅 references/USAGE.md。

数据架构

该技能通过 REST API 操作 Jira 的问题和工作流数据；它不涉及单独的本地问题数据库或生成的数据文件。
数据或元数据 来源或用途
连接设置 环境变量，例如 JIRA_URL、JIRA_USER、JIRA_TOKEN 和 JIRA_AUTH，或 ~/ .devops-skills/jira.json
问题标识符 Jira 问题键，例如 PROJ-123，用于需要操作现有问题的命令
搜索条件 传递给 search 的 JQL 字符串，可选设置结果数量上限
问题创建字段 传递给 create-issue 的项目、问题类型、摘要和描述
工作流元数据 list-transitions 返回的可用转换；使用 transition 时须指定有效目标
指派元数据 通过 assign --user 提供的用户；Server 通常使用用户名，而 Cloud 可能需要账户 ID
命令输出 写入 stdout 的 JSON；失败时以非零退出码表示
除 Jira 自有的项目、问题类型、状态和用户标识符外，该技能不定义自定义分类体系。

高级特性

支持 Jira Cloud 和 Jira Server 或 Data Center 7.0 及更高版本。
为 Cloud 基本身份验证或 Server/Data Center bearer-token 身份验证选择相应的身份验证行为。
在执行命令前检查 Jira 服务器版本；必要时设置
JIRA_SKIP_VERSION_CHECK=1
DEVOPS_SKILLS_SKIP_VERSION_CHECK=1
跳过检查。
将问题操作作为 CLI 子命令提供，并输出 JSON，供下游工具或代理工作流使用。
支持可配置结果数量上限的 JQL 搜索。
提供两步式工作流转换模式：先检查有效转换，再应用选定目标。
将问题创建、评论、指派和转换视为写入操作，执行前需要用户确认。

name: jira-skills description: Manage Jira issues from the command line — read, search (JQL), create, comment on, assign, and transition issues. Use whenever the user wants to query a Jira ticket, file a bug or task, move an issue across its workflow, leave a comment, or run a JQL search against Jira Cloud, Server, or Data Center. 中文触发场景：查 Jira 单据、JQL 查询、建缺陷/任务、加评论、流转状态、指派经办人。

Jira 技能（命令行实操）

通过 Jira REST API 操作单据，入口是单一自包含的 Python CLI：scripts/jira_cli.py。 兼容 Jira Cloud、Server 与 Data Center。License: MIT。

何时使用

用户提出以下需求时调用本技能：

查单据（"看下 PROJ-123""PROJ-45 现在什么状态"）
搜索（"分配给我的未关闭缺陷"，或任意 JQL）
建单（"在 PROJ 建一个任务，标题是……"）
评论、指派、按工作流流转（"把 PROJ-12 置为完成"）
环境配置（首次）

连接信息从环境变量读取，或放在配置文件 ~/.devops-skills/jira.json。 禁止把 token 直接写在命令行参数里。

export JIRA_URL="https://your-domain.atlassian.net"
export JIRA_USER="you@example.com" # Cloud 用邮箱 / Server 用用户名
export JIRA_TOKEN=""
export JIRA_AUTH="basic" # Cloud 用 basic，Server/DC 的 PAT 用 bearer

运行方式

脚本依赖 requests。本机受管 Python 环境已安装（requests 2.34.2），推荐直接用绝对路径调用， 避免默认的 python3 缺少依赖而失败：

PY=~/.workbuddy/binaries/python/envs/default/bin/python

# 若报 Missing dependency，用同一个解释器装：
# $PY -m pip install requests -i https://mirrors.aliyun.com/pypi/simple/

$PY scripts/jira_cli.py get-issue PROJ-123
$PY scripts/jira_cli.py search "project = PROJ AND status = 'In Progress'" --limit 20
$PY scripts/jira_cli.py create-issue --project PROJ --type Bug --summary "Login fails" --description "Steps..."
$PY scripts/jira_cli.py comment PROJ-123 --body "Looking into this"
$PY scripts/jira_cli.py list-transitions PROJ-123
$PY scripts/jira_cli.py transition PROJ-123 --to "Done"
$PY scripts/jira_cli.py assign PROJ-123 --user jdoe

所有命令把 JSON 打到 stdout，失败时以非零退出码结束。 做状态流转时，先 list-transitions 拿到合法目标状态名，再 transition。

兼容性

Jira Cloud

Jira Server / Data Center 7.0+

执行命令前会请求 /rest/api/2/serverInfo 做版本校验，检测到 Server/DC 低于 7.0 会输出明确的兼容性提示并退出。 确需绕过时可设 JIRA_SKIP_VERSION_CHECK=1 或 DEVOPS_SKILLS_SKIP_VERSION_CHECK=1。

注意事项

Cloud 用「邮箱 + API Token」配 JIRA_AUTH=basic。
Server/DC 的 Personal Access Token 用 JIRA_AUTH=bearer（用户名可省略）。
assign --user 在 Server 用 name，Cloud 上可能需要 accountId。
建单、评论、流转、指派都是写操作（🟡 级），执行前跟用户确认单据号与目标值。
详细文档

完整的配置方式、字段说明与排错见 references/USAGE.md。

联系与支持

Jira 工作流、权限、自动化或研发交付流程问题需要人工支持时联系： 📧 77890866@qq.com　|　🌐 https://www.restartx.top

Jenkins 技能
JF 垃圾溢出巡检