{"id":"2bf68ba2-33cc-41fd-b588-c8ceb780abe9","entityType":"agent","slug":"clawhub-weiguang1017-jira-devops-skill","name":"Jira Skills","canonicalUrl":"https://www.xpersona.co/agent/clawhub-weiguang1017-jira-devops-skill","canonicalPath":"/agent/clawhub-weiguang1017-jira-devops-skill","generatedAt":"2026-10-09T21:12:35.433Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T13:53:24.955Z","emptyReason":null},"description":"Jira issue and workflow operations","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.5K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s178r18ph3sn297gb4d96zefvx88583r:jira-devops-skill","sourceUrl":"https://clawhub.ai/weiguang1017/jira-devops-skill","homepage":"https://clawhub.ai/weiguang1017/skills/jira-devops-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/weiguang1017/jira-devops-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/weiguang1017/skills/jira-devops-skill","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":68,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Jira Skills technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T13:53:24.955Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T13:53:24.955Z","emptyReason":null},"stars":null,"forks":null,"downloads":2534,"packageName":null,"latestVersion":"0.1.1","tractionLabel":"2.5K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T13:53:24.955Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T13:53:24.955Z","lastCrawledAt":"2026-10-09T13:53:24.955Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T13:53:24.955Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.1","createdAt":"2026-10-08T08:11:01.076Z","changelog":"- Added detailed Chinese documentation and usage instructions to SKILL.md. - Moved full configuration and troubleshooting docs to new references/USAGE.md. - Removed outdated/duplicate documentation files (skill-card.md, 使用手册.md) for clarity. - Updated environment setup and compatibility notes, emphasizing best practices for Python dependencies. - Provided clearer support and contact information.","fileCount":9,"zipByteSize":12392},{"version":"0.1.0","createdAt":"2026-08-05T05:23:10.852Z","changelog":"Initial release of jira-devops-skill. - Provides a command-line interface to manage Jira issues (read, search, create, comment, assign, transition). - Supports Jira Cloud, Server, and Data Center (version 7.0+). - Simple configuration via environment variables or `jira.json` file; tokens are never passed on the command line. - Includes built-in version compatibility checks and clear error messaging. - Outputs JSON for all operations and uses non-zero exit codes on failure. - Full Python 3.8+ support; requires only the `requests` package.","fileCount":11,"zipByteSize":12278}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s178r18ph3sn297gb4d96zefvx88583r:jira-devops-skill","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s178r18ph3sn297gb4d96zefvx88583r:jira-devops-skill` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/weiguang1017/jira-devops-skill before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jira-devops-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jira-devops-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jira-devops-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jira-devops-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jira-devops-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jira-devops-skill/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T21:12:35.432Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jira-devops-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jira-devops-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jira-devops-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jira-devops-skill/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T13:53:24.955Z","emptyReason":null},"readme":"Skill: Jira Skills\n\nOwner: weiguang1017\n\nSummary: Jira issue and workflow operations\n\nTags: latest:0.1.1\n\nVersion history:\n\nv0.1.1 | 2026-10-08T08:11:01.076Z | auto\n\n- Added detailed Chinese documentation and usage instructions to SKILL.md.\n- Moved full configuration and troubleshooting docs to new references/USAGE.md.\n- Removed outdated/duplicate documentation files (skill-card.md, 使用手册.md) for clarity.\n- Updated environment setup and compatibility notes, emphasizing best practices for Python dependencies.\n- Provided clearer support and contact information.\n\nv0.1.0 | 2026-08-05T05:23:10.852Z | auto\n\nInitial release of jira-devops-skill.\n\n- Provides a command-line interface to manage Jira issues (read, search, create, comment, assign, transition).\n- Supports Jira Cloud, Server, and Data Center (version 7.0+).\n- Simple configuration via environment variables or `jira.json` file; tokens are never passed on the command line.\n- Includes built-in version compatibility checks and clear error messaging.\n- Outputs JSON for all operations and uses non-zero exit codes on failure.\n- Full Python 3.8+ support; requires only the `requests` package.\n\nArchive index:\n\nArchive v0.1.1: 9 files, 12392 bytes\n\nFiles: agents/openai.yaml (239b), LICENSE (1083b), README.md (4754b), references/USAGE.md (4315b), requirements.txt (18b), scripts/jira_cli.py (8763b), skill-card.md (1954b), SKILL.md (3397b), _meta.json (136b)\n\nFile v0.1.1:SKILL.md\n\n---\nname: jira-skills\ndescription: 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 查询、建缺陷/任务、加评论、流转状态、指派经办人。\n---\n\n# Jira 技能（命令行实操）\n\n通过 Jira REST API 操作单据，入口是单一自包含的 Python CLI：`scripts/jira_cli.py`。\n兼容 Jira Cloud、Server 与 Data Center。License: MIT。\n\n## 何时使用\n\n用户提出以下需求时调用本技能：\n\n- 查单据（\"看下 PROJ-123\"\"PROJ-45 现在什么状态\"）\n- 搜索（\"分配给我的未关闭缺陷\"，或任意 JQL）\n- 建单（\"在 PROJ 建一个任务，标题是……\"）\n- 评论、指派、按工作流流转（\"把 PROJ-12 置为完成\"）\n\n## 环境配置（首次）\n\n连接信息从环境变量读取，或放在配置文件 `~/.devops-skills/jira.json`。\n**禁止把 token 直接写在命令行参数里。**\n\n```bash\nexport JIRA_URL=\"https://your-domain.atlassian.net\"\nexport JIRA_USER=\"you@example.com\"     # Cloud 用邮箱 / Server 用用户名\nexport JIRA_TOKEN=\"<api-token-or-PAT>\"\nexport JIRA_AUTH=\"basic\"               # Cloud 用 basic，Server/DC 的 PAT 用 bearer\n```\n\n## 运行方式\n\n脚本依赖 `requests`。本机受管 Python 环境已安装（requests 2.34.2），**推荐直接用绝对路径调用**，\n避免默认的 `python3` 缺少依赖而失败：\n\n```bash\nPY=~/.workbuddy/binaries/python/envs/default/bin/python\n# 若报 Missing dependency，用同一个解释器装：\n# $PY -m pip install requests -i https://mirrors.aliyun.com/pypi/simple/\n```\n\n```bash\n$PY scripts/jira_cli.py get-issue PROJ-123\n$PY scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\" --limit 20\n$PY scripts/jira_cli.py create-issue --project PROJ --type Bug --summary \"Login fails\" --description \"Steps...\"\n$PY scripts/jira_cli.py comment PROJ-123 --body \"Looking into this\"\n$PY scripts/jira_cli.py list-transitions PROJ-123\n$PY scripts/jira_cli.py transition PROJ-123 --to \"Done\"\n$PY scripts/jira_cli.py assign PROJ-123 --user jdoe\n```\n\n所有命令把 JSON 打到 stdout，失败时以非零退出码结束。\n做状态流转时，**先 `list-transitions` 拿到合法目标状态名，再 `transition`**。\n\n## 兼容性\n\n- Jira Cloud\n- Jira Server / Data Center 7.0+\n\n执行命令前会请求 `/rest/api/2/serverInfo` 做版本校验，检测到 Server/DC 低于 7.0 会输出明确的兼容性提示并退出。\n确需绕过时可设 `JIRA_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。\n\n## 注意事项\n\n- Cloud 用「邮箱 + API Token」配 `JIRA_AUTH=basic`。\n- Server/DC 的 Personal Access Token 用 `JIRA_AUTH=bearer`（用户名可省略）。\n- `assign --user` 在 Server 用 `name`，Cloud 上可能需要 accountId。\n- 建单、评论、流转、指派都是写操作（🟡 级），执行前跟用户确认单据号与目标值。\n\n## 详细文档\n\n完整的配置方式、字段说明与排错见 `references/USAGE.md`。\n\n## 联系与支持\n\nJira 工作流、权限、自动化或研发交付流程问题需要人工支持时联系：\n📧 77890866@qq.com　|　🌐 https://www.restartx.top\n\nFile v0.1.1:README.md\n\n# Jira DevOps Skill\n\n[English](#english) | [中文](#chinese)\n\n<a id=\"english\"></a>\n## English\n\nManage Jira issues from the command line through the Jira REST API. The included\nPython CLI can read issues, run JQL searches, create issues, add comments, assign\nowners, and transition issues through a workflow.\n\n### Compatibility\n\n- Jira Cloud\n- Jira Server or Data Center 7.0+\n- Python 3.8+ and `requests`\n\nBefore normal execution, the CLI reads `/rest/api/2/serverInfo`. Server or Data\nCenter instances below 7.0 fail with a clear compatibility error. Do not bypass\nthe check unless compatibility has been independently verified.\n\n### Quick Start\n\n```bash\npip install requests\nexport JIRA_URL=\"https://your-jira.example.com\"\nexport JIRA_USER=\"you@example.com\"\nexport JIRA_TOKEN=\"<api-token-or-pat>\"\nexport JIRA_AUTH=\"basic\"  # Use bearer for a Server/DC PAT\n\npython scripts/jira_cli.py get-issue PROJ-123\npython scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\"\n```\n\nConnection settings can instead be stored in `~/.devops-skills/jira.json`.\nKeep that file outside version control and set its permissions to `600`.\n\n### Common Commands\n\n| Task | Command |\n| --- | --- |\n| Read an issue | `python scripts/jira_cli.py get-issue PROJ-123` |\n| Search with JQL | `python scripts/jira_cli.py search \"project = PROJ\" --limit 20` |\n| Create an issue | `python scripts/jira_cli.py create-issue --project PROJ --type Bug --summary \"Login fails\"` |\n| Add a comment | `python scripts/jira_cli.py comment PROJ-123 --body \"Investigating\"` |\n| List transitions | `python scripts/jira_cli.py list-transitions PROJ-123` |\n| Transition an issue | `python scripts/jira_cli.py transition PROJ-123 --to \"Done\"` |\n| Assign an owner | `python scripts/jira_cli.py assign PROJ-123 --user jdoe` |\n\n### Permissions and Safety\n\nRead operations need project browse and issue-view permissions. Grant create,\ncomment, assign, or transition permissions only when those actions are needed.\nThis skill does not need Jira global administration or permission-scheme\nadministration. Check available transitions before changing an issue state.\n\n### Documentation and Support\n\n- Agent instructions: [SKILL.md](./SKILL.md)\n- Detailed Chinese manual: [使用手册.md](./使用手册.md)\n- Support: https://service.restartx.top/\n\nFor Jira workflow, permissions, automation, DevOps platform, or engineering\nefficiency questions, RestartX provides technical support and implementation\nservices through the support address above.\n\n<a id=\"chinese\"></a>\n## 中文\n\n通过 Jira REST API 从命令行管理 Issue。内置 Python CLI 支持查看工单、JQL 搜索、创建\nIssue、添加评论、指派负责人和按工作流流转状态。\n\n### 兼容性\n\n- Jira Cloud\n- Jira Server 或 Data Center 7.0+\n- Python 3.8+ 与 `requests`\n\n脚本会在正常执行前请求 `/rest/api/2/serverInfo`。当 Server 或 Data Center 低于 7.0 时，\n会给出明确的不兼容错误并停止执行；除非已独立确认兼容性，否则不要跳过检查。\n\n### 快速开始\n\n```bash\npip install requests\nexport JIRA_URL=\"https://your-jira.example.com\"\nexport JIRA_USER=\"you@example.com\"\nexport JIRA_TOKEN=\"<api-token-or-pat>\"\nexport JIRA_AUTH=\"basic\"  # Server/DC PAT 使用 bearer\n\npython scripts/jira_cli.py get-issue PROJ-123\npython scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\"\n```\n\n也可将连接信息保存到 `~/.devops-skills/jira.json`。该文件必须位于版本库之外，并设置为\n`600` 权限。\n\n### 常用命令\n\n| 功能 | 命令 |\n| --- | --- |\n| 查看 Issue | `python scripts/jira_cli.py get-issue PROJ-123` |\n| JQL 搜索 | `python scripts/jira_cli.py search \"project = PROJ\" --limit 20` |\n| 创建 Issue | `python scripts/jira_cli.py create-issue --project PROJ --type Bug --summary \"Login fails\"` |\n| 添加评论 | `python scripts/jira_cli.py comment PROJ-123 --body \"Investigating\"` |\n| 查看可用流转 | `python scripts/jira_cli.py list-transitions PROJ-123` |\n| 流转 Issue | `python scripts/jira_cli.py transition PROJ-123 --to \"Done\"` |\n| 指派负责人 | `python scripts/jira_cli.py assign PROJ-123 --user jdoe` |\n\n### 权限与安全\n\n只读操作需要目标项目的浏览项目和查看 Issue 权限。只有在需要时才授予创建、评论、指派或\n流转权限；本 Skill 不需要 Jira 全局管理员或权限方案管理权限。变更状态前应先查询可用流转。\n\n### 文档与支持\n\n- Agent 指令：[SKILL.md](./SKILL.md)\n- 完整中文手册：[使用手册.md](./使用手册.md)\n- 支持地址：https://service.restartx.top/\n\n如遇 Jira 工作流、权限、自动化、DevOps 平台或研发效能问题，可通过上述地址联系 RestartX\n获取技术支持与实施服务。\n\nFile v0.1.1:_meta.json\n\n{\n  \"ownerId\": \"kn7abv05p1jqkcnmnmkdpdex9581nt3f\",\n  \"slug\": \"jira-devops-skill\",\n  \"version\": \"0.1.1\",\n  \"publishedAt\": 1791447061076\n}\n\nFile v0.1.1:references/USAGE.md\n\n# Jira Skills 配置与使用手册\n\n通过一个零配置文件依赖的 Python CLI 操作 Jira，支持 Jira Cloud / Server / Data Center。\n\n---\n\n## 一、环境要求\n\n- Python 3.8 及以上\n- 安装依赖：`pip install requests`\n- Jira Cloud，或 Jira Server / Data Center 7.0 及以上\n\n脚本会在执行命令前通过 `/rest/api/2/serverInfo` 检测 Jira 版本；若自建 Jira\n版本低于 7.0，会直接给出明确的不兼容提示。确需跳过检查时，可设置\n`JIRA_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。\n\n---\n\n## 二、获取访问凭证\n\n### Jira Cloud（xxx.atlassian.net）\n1. 登录 Jira，访问 https://id.atlassian.com/manage-profile/security/api-tokens\n2. 点击 **Create API token**，复制生成的 token。\n3. 认证方式为 **basic**：用户名填你的登录邮箱，密码填该 token。\n\n### Jira Server / Data Center（自建）\n1. 头像 → **Personal Access Tokens** → **Create token**。\n2. 认证方式为 **bearer**：只需 token，无需用户名。\n\n---\n\n## 三、配置连接信息（二选一）\n\n### 方式 A：环境变量（推荐，适合临时/CI）\n\n```bash\nexport JIRA_URL=\"https://your-domain.atlassian.net\"\nexport JIRA_USER=\"you@example.com\"      # bearer 模式可省略\nexport JIRA_TOKEN=\"你的token\"\nexport JIRA_AUTH=\"basic\"                # Cloud 用 basic；Server/DC PAT 用 bearer\n```\n\n### 方式 B：配置文件（推荐，适合本地长期使用）\n\n创建 `~/.devops-skills/jira.json`：\n\n```json\n{\n  \"url\": \"https://your-domain.atlassian.net\",\n  \"user\": \"you@example.com\",\n  \"token\": \"你的token\",\n  \"auth\": \"basic\"\n}\n```\n\n> 安全建议：`chmod 600 ~/.devops-skills/jira.json`，切勿把 token 提交到仓库。\n\n---\n\n## 四、命令速查\n\n| 功能 | 命令 |\n| --- | --- |\n| 查看 issue | `python scripts/jira_cli.py get-issue PROJ-123` |\n| JQL 搜索 | `python scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\" --limit 20` |\n| 创建 issue | `python scripts/jira_cli.py create-issue --project PROJ --type Bug --summary \"标题\" --description \"描述\"` |\n| 添加评论 | `python scripts/jira_cli.py comment PROJ-123 --body \"评论内容\"` |\n| 查看可用流转 | `python scripts/jira_cli.py list-transitions PROJ-123` |\n| 流转状态 | `python scripts/jira_cli.py transition PROJ-123 --to \"Done\"` |\n| 指派负责人 | `python scripts/jira_cli.py assign PROJ-123 --user jdoe` |\n\n---\n\n## 五、使用示例\n\n**1. 查看一个工单的状态**\n\n```bash\npython scripts/jira_cli.py get-issue PROJ-123\n```\n\n输出（JSON）：\n\n```json\n{\n  \"key\": \"PROJ-123\",\n  \"summary\": \"登录失败\",\n  \"status\": \"In Progress\",\n  \"assignee\": \"张三\",\n  \"type\": \"Bug\"\n}\n```\n\n**2. 创建一个 Bug 并指派**\n\n```bash\npython scripts/jira_cli.py create-issue \\\n  --project PROJ --type Bug \\\n  --summary \"登录接口 500\" \\\n  --description \"复现步骤：...\" \\\n  --assignee zhangsan\n```\n\n**3. 把工单流转到 Done（先查再转）**\n\n```bash\npython scripts/jira_cli.py list-transitions PROJ-123   # 先看有哪些目标状态\npython scripts/jira_cli.py transition PROJ-123 --to \"Done\"\n```\n\n---\n\n## 六、常见问题\n\n| 现象 | 原因与解决 |\n| --- | --- |\n| `JIRA_URL and JIRA_TOKEN are required` | 未配置环境变量或配置文件 |\n| `HTTP 401` | token 失效或认证方式不匹配（Cloud 用 basic，Server PAT 用 bearer） |\n| `HTTP 403` | 账号没有对应项目/操作权限 |\n| `unsupported Jira version ...` | Jira Server/Data Center 版本低于 7.0，请升级 Jira 或使用旧版 skill |\n| `no transition \"Done\"` | 目标状态名不对，先用 `list-transitions` 查看准确名称 |\n| assign 在 Cloud 报错 | Cloud 较新版本需用 accountId，请用 Server 用户名或在 Cloud 用 accountId |\n\n---\n\n## 七、在 Claude / Claude Code 中使用\n\n将 `jira-skills` 目录放入 skills 目录后，直接用自然语言即可触发，例如：\n\n- “看下 PROJ-123 现在什么状态”\n- “在 PROJ 里建个 Bug，标题是登录接口 500”\n- “把 PROJ-123 流转到 Done”\n\nClaude 会自动调用本 skill 的对应命令。\n\n---\n\n## 八、技术支持与咨询\n\n如果在 Jira 工作流、权限、自动化、DevOps 平台或研发效能建设中遇到问题，欢迎联系\nRestartX 获取支持与方案咨询：https://service.restartx.top/\n\nFile v0.1.1:skill-card.md\n\n## Description:\n\nHelps agents read, search, create, comment on, assign, and transition Jira issues across Jira Cloud, Server, and Data Center.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[weiguang1017](https://clawhub.ai/user/weiguang1017)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nDevelopers and teams use this skill to inspect Jira issues, search with JQL, and manage issue creation, comments, assignments, and workflow transitions.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Write actions can change live Jira issues without a built-in confirmation gate, including after automatic invocation.\n\nMitigation: Before creating, commenting, assigning, or transitioning, show the exact issue key, operation, and target value and obtain user confirmation.\n\nRisk: Jira credentials can grant more access than the task requires or be exposed if stored insecurely.\n\nMitigation: Use an account with only the needed project permissions; keep tokens in environment variables or a protected config file outside version control.\n\n## Reference(s):\n\n- [Source repository (server-resolved provenance)](https://github.com/weiguang1017/jira-devops-skill)\n- [ClawHub skill release](https://clawhub.ai/weiguang1017/skills/jira-devops-skill)\n- [Jira Skills usage guide](references/USAGE.md)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Text]\n\n**Output Format:** [Markdown guidance and JSON command results]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Command results vary by operation; errors return a nonzero exit status.]\n\n## Skill Version(s):\n\n0.1.1 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v0.1.1:agents/openai.yaml\n\ninterface:\n  display_name: \"Jira DevOps\"\n  short_description: \"Jira issue and workflow operations\"\n  default_prompt: \"Use $jira-skills to inspect a Jira issue and recommend the next safe action.\"\n\npolicy:\n  allow_implicit_invocation: true\n\nFile v0.1.1:LICENSE\n\nMIT License\n\nCopyright (c) 2026 devops-skills contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nFile v0.1.1:requirements.txt\n\nrequests>=2.25,<3\n\nArchive v0.1.0: 11 files, 12278 bytes\n\nFiles: agents (0b), agents/openai.yaml (239b), LICENSE (1083b), README.md (4754b), requirements.txt (18b), scripts (0b), scripts/jira_cli.py (8763b), skill-card.md (2566b), SKILL.md (2890b), 使用手册.md (4315b), _meta.json (136b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: jira-skills\ndescription: Manage Jira issues from the command line — read, search (JQL), create, comment on, assign, and transition issues. Use this 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.\nlicense: MIT\n---\n\n# Jira Skills\n\nOperate a Jira instance through its REST API with a single, self-contained Python\nCLI (`scripts/jira_cli.py`). Works with Jira Cloud, Server, and Data Center.\n\n## When to use\n\nTrigger this skill when the user asks to:\n- look up a ticket (\"show JIRA-123\", \"what's the status of PROJ-45\")\n- search issues (\"open bugs assigned to me\", any JQL query)\n- create an issue (\"file a task in PROJ titled ...\")\n- comment, assign, or move an issue through its workflow (\"mark JIRA-12 Done\")\n\n## Setup (once)\n\nThe script reads connection info from environment variables OR\n`~/.devops-skills/jira.json`. Never pass tokens on the command line.\n\n```bash\nexport JIRA_URL=\"https://your-domain.atlassian.net\"\nexport JIRA_USER=\"you@example.com\"     # email (Cloud) / username (Server)\nexport JIRA_TOKEN=\"<api-token-or-PAT>\"\nexport JIRA_AUTH=\"basic\"               # \"basic\" for Cloud, \"bearer\" for Server/DC PAT\n```\n\nRequires Python 3.8+ and `requests` (`pip install requests`).\nFull configuration walk-through: see `使用手册.md`.\n\n## Compatibility\n\nSupported targets:\n- Jira Cloud\n- Jira Server / Data Center 7.0+\n\nThe CLI checks the Jira version through `/rest/api/2/serverInfo` before running\ncommands. If the detected Server/Data Center version is below 7.0, it exits with\na clear compatibility message. Set `JIRA_SKIP_VERSION_CHECK=1` or\n`DEVOPS_SKILLS_SKIP_VERSION_CHECK=1` only when you deliberately need to bypass\nthis guard.\n\n## Usage\n\n```bash\npython scripts/jira_cli.py get-issue PROJ-123\npython scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\" --limit 20\npython scripts/jira_cli.py create-issue --project PROJ --type Bug --summary \"Login fails\" --description \"Steps...\"\npython scripts/jira_cli.py comment PROJ-123 --body \"Looking into this\"\npython scripts/jira_cli.py list-transitions PROJ-123\npython scripts/jira_cli.py transition PROJ-123 --to \"Done\"\npython scripts/jira_cli.py assign PROJ-123 --user jdoe\n```\n\nEvery command prints JSON to stdout and exits non-zero on failure. For workflow\nmoves, prefer `list-transitions` first to discover valid target names, then\n`transition`.\n\n## Notes\n\n- Cloud uses email + API token with `JIRA_AUTH=basic`.\n- Server/DC personal access tokens use `JIRA_AUTH=bearer` (username optional).\n- `--user` for assign uses `name` (Server) / accountId may be required on Cloud.\n\n## Support\n\nIf you run into Jira workflow, permission, automation, or DevOps delivery\nquestions, RestartX can help with troubleshooting and solution design:\nhttps://service.restartx.top/\n\nFile v0.1.0:README.md\n\n# Jira DevOps Skill\n\n[English](#english) | [中文](#chinese)\n\n<a id=\"english\"></a>\n## English\n\nManage Jira issues from the command line through the Jira REST API. The included\nPython CLI can read issues, run JQL searches, create issues, add comments, assign\nowners, and transition issues through a workflow.\n\n### Compatibility\n\n- Jira Cloud\n- Jira Server or Data Center 7.0+\n- Python 3.8+ and `requests`\n\nBefore normal execution, the CLI reads `/rest/api/2/serverInfo`. Server or Data\nCenter instances below 7.0 fail with a clear compatibility error. Do not bypass\nthe check unless compatibility has been independently verified.\n\n### Quick Start\n\n```bash\npip install requests\nexport JIRA_URL=\"https://your-jira.example.com\"\nexport JIRA_USER=\"you@example.com\"\nexport JIRA_TOKEN=\"<api-token-or-pat>\"\nexport JIRA_AUTH=\"basic\"  # Use bearer for a Server/DC PAT\n\npython scripts/jira_cli.py get-issue PROJ-123\npython scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\"\n```\n\nConnection settings can instead be stored in `~/.devops-skills/jira.json`.\nKeep that file outside version control and set its permissions to `600`.\n\n### Common Commands\n\n| Task | Command |\n| --- | --- |\n| Read an issue | `python scripts/jira_cli.py get-issue PROJ-123` |\n| Search with JQL | `python scripts/jira_cli.py search \"project = PROJ\" --limit 20` |\n| Create an issue | `python scripts/jira_cli.py create-issue --project PROJ --type Bug --summary \"Login fails\"` |\n| Add a comment | `python scripts/jira_cli.py comment PROJ-123 --body \"Investigating\"` |\n| List transitions | `python scripts/jira_cli.py list-transitions PROJ-123` |\n| Transition an issue | `python scripts/jira_cli.py transition PROJ-123 --to \"Done\"` |\n| Assign an owner | `python scripts/jira_cli.py assign PROJ-123 --user jdoe` |\n\n### Permissions and Safety\n\nRead operations need project browse and issue-view permissions. Grant create,\ncomment, assign, or transition permissions only when those actions are needed.\nThis skill does not need Jira global administration or permission-scheme\nadministration. Check available transitions before changing an issue state.\n\n### Documentation and Support\n\n- Agent instructions: [SKILL.md](./SKILL.md)\n- Detailed Chinese manual: [使用手册.md](./使用手册.md)\n- Support: https://service.restartx.top/\n\nFor Jira workflow, permissions, automation, DevOps platform, or engineering\nefficiency questions, RestartX provides technical support and implementation\nservices through the support address above.\n\n<a id=\"chinese\"></a>\n## 中文\n\n通过 Jira REST API 从命令行管理 Issue。内置 Python CLI 支持查看工单、JQL 搜索、创建\nIssue、添加评论、指派负责人和按工作流流转状态。\n\n### 兼容性\n\n- Jira Cloud\n- Jira Server 或 Data Center 7.0+\n- Python 3.8+ 与 `requests`\n\n脚本会在正常执行前请求 `/rest/api/2/serverInfo`。当 Server 或 Data Center 低于 7.0 时，\n会给出明确的不兼容错误并停止执行；除非已独立确认兼容性，否则不要跳过检查。\n\n### 快速开始\n\n```bash\npip install requests\nexport JIRA_URL=\"https://your-jira.example.com\"\nexport JIRA_USER=\"you@example.com\"\nexport JIRA_TOKEN=\"<api-token-or-pat>\"\nexport JIRA_AUTH=\"basic\"  # Server/DC PAT 使用 bearer\n\npython scripts/jira_cli.py get-issue PROJ-123\npython scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\"\n```\n\n也可将连接信息保存到 `~/.devops-skills/jira.json`。该文件必须位于版本库之外，并设置为\n`600` 权限。\n\n### 常用命令\n\n| 功能 | 命令 |\n| --- | --- |\n| 查看 Issue | `python scripts/jira_cli.py get-issue PROJ-123` |\n| JQL 搜索 | `python scripts/jira_cli.py search \"project = PROJ\" --limit 20` |\n| 创建 Issue | `python scripts/jira_cli.py create-issue --project PROJ --type Bug --summary \"Login fails\"` |\n| 添加评论 | `python scripts/jira_cli.py comment PROJ-123 --body \"Investigating\"` |\n| 查看可用流转 | `python scripts/jira_cli.py list-transitions PROJ-123` |\n| 流转 Issue | `python scripts/jira_cli.py transition PROJ-123 --to \"Done\"` |\n| 指派负责人 | `python scripts/jira_cli.py assign PROJ-123 --user jdoe` |\n\n### 权限与安全\n\n只读操作需要目标项目的浏览项目和查看 Issue 权限。只有在需要时才授予创建、评论、指派或\n流转权限；本 Skill 不需要 Jira 全局管理员或权限方案管理权限。变更状态前应先查询可用流转。\n\n### 文档与支持\n\n- Agent 指令：[SKILL.md](./SKILL.md)\n- 完整中文手册：[使用手册.md](./使用手册.md)\n- 支持地址：https://service.restartx.top/\n\n如遇 Jira 工作流、权限、自动化、DevOps 平台或研发效能问题，可通过上述地址联系 RestartX\n获取技术支持与实施服务。\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn7abv05p1jqkcnmnmkdpdex9581nt3f\",\n  \"slug\": \"jira-devops-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1785907390852\n}\n\nFile v0.1.0:skill-card.md\n\n## Description:\n\nManage Jira issues from the command line via the Jira REST API, including reads, JQL searches, issue creation, comments, assignment, and workflow transitions.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[weiguang1017](https://clawhub.ai/user/weiguang1017)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nDevelopers and DevOps engineers use this skill to inspect Jira tickets, search with JQL, create issues, add comments, assign owners, and move issues through Jira workflows. It supports Jira Cloud, Jira Server, and Jira Data Center 7.0+ when configured with an appropriate Jira account.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can use configured Jira credentials to create, comment on, assign, or transition live Jira issues.\n\nMitigation: Use a least-privilege Jira token and require human confirmation before write actions.\n\nRisk: The security summary says HTTPS Jira URLs and write confirmations are not enforced by the skill.\n\nMitigation: Configure only HTTPS Jira URLs and avoid granting production write permissions unless they are needed.\n\nRisk: Implicit invocation is enabled in the agent configuration.\n\nMitigation: Consider disabling implicit invocation for sensitive Jira environments or requiring an explicit approval step before execution.\n\nRisk: The skill depends on the requests package for Jira API calls.\n\nMitigation: Pin and update the requests dependency as part of normal dependency maintenance.\n\n## Reference(s):\n\n- [Server-resolved GitHub repository](https://github.com/weiguang1017/jira-devops-skill)\n- [ClawHub skill page](https://clawhub.ai/weiguang1017/skills/jira-devops-skill)\n- [Agent instructions](artifact/SKILL.md)\n- [README](artifact/README.md)\n- [Chinese usage manual](artifact/使用手册.md)\n- [Support](https://service.restartx.top/)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with inline shell commands and JSON CLI output]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [The CLI prints JSON for successful operations and exits non-zero with stderr diagnostics on failures.]\n\n## Skill Version(s):\n\n0.1.0 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v0.1.0:使用手册.md\n\n# Jira Skills 配置与使用手册\n\n通过一个零配置文件依赖的 Python CLI 操作 Jira，支持 Jira Cloud / Server / Data Center。\n\n---\n\n## 一、环境要求\n\n- Python 3.8 及以上\n- 安装依赖：`pip install requests`\n- Jira Cloud，或 Jira Server / Data Center 7.0 及以上\n\n脚本会在执行命令前通过 `/rest/api/2/serverInfo` 检测 Jira 版本；若自建 Jira\n版本低于 7.0，会直接给出明确的不兼容提示。确需跳过检查时，可设置\n`JIRA_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。\n\n---\n\n## 二、获取访问凭证\n\n### Jira Cloud（xxx.atlassian.net）\n1. 登录 Jira，访问 https://id.atlassian.com/manage-profile/security/api-tokens\n2. 点击 **Create API token**，复制生成的 token。\n3. 认证方式为 **basic**：用户名填你的登录邮箱，密码填该 token。\n\n### Jira Server / Data Center（自建）\n1. 头像 → **Personal Access Tokens** → **Create token**。\n2. 认证方式为 **bearer**：只需 token，无需用户名。\n\n---\n\n## 三、配置连接信息（二选一）\n\n### 方式 A：环境变量（推荐，适合临时/CI）\n\n```bash\nexport JIRA_URL=\"https://your-domain.atlassian.net\"\nexport JIRA_USER=\"you@example.com\"      # bearer 模式可省略\nexport JIRA_TOKEN=\"你的token\"\nexport JIRA_AUTH=\"basic\"                # Cloud 用 basic；Server/DC PAT 用 bearer\n```\n\n### 方式 B：配置文件（推荐，适合本地长期使用）\n\n创建 `~/.devops-skills/jira.json`：\n\n```json\n{\n  \"url\": \"https://your-domain.atlassian.net\",\n  \"user\": \"you@example.com\",\n  \"token\": \"你的token\",\n  \"auth\": \"basic\"\n}\n```\n\n> 安全建议：`chmod 600 ~/.devops-skills/jira.json`，切勿把 token 提交到仓库。\n\n---\n\n## 四、命令速查\n\n| 功能 | 命令 |\n| --- | --- |\n| 查看 issue | `python scripts/jira_cli.py get-issue PROJ-123` |\n| JQL 搜索 | `python scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\" --limit 20` |\n| 创建 issue | `python scripts/jira_cli.py create-issue --project PROJ --type Bug --summary \"标题\" --description \"描述\"` |\n| 添加评论 | `python scripts/jira_cli.py comment PROJ-123 --body \"评论内容\"` |\n| 查看可用流转 | `python scripts/jira_cli.py list-transitions PROJ-123` |\n| 流转状态 | `python scripts/jira_cli.py transition PROJ-123 --to \"Done\"` |\n| 指派负责人 | `python scripts/jira_cli.py assign PROJ-123 --user jdoe` |\n\n---\n\n## 五、使用示例\n\n**1. 查看一个工单的状态**\n\n```bash\npython scripts/jira_cli.py get-issue PROJ-123\n```\n\n输出（JSON）：\n\n```json\n{\n  \"key\": \"PROJ-123\",\n  \"summary\": \"登录失败\",\n  \"status\": \"In Progress\",\n  \"assignee\": \"张三\",\n  \"type\": \"Bug\"\n}\n```\n\n**2. 创建一个 Bug 并指派**\n\n```bash\npython scripts/jira_cli.py create-issue \\\n  --project PROJ --type Bug \\\n  --summary \"登录接口 500\" \\\n  --description \"复现步骤：...\" \\\n  --assignee zhangsan\n```\n\n**3. 把工单流转到 Done（先查再转）**\n\n```bash\npython scripts/jira_cli.py list-transitions PROJ-123   # 先看有哪些目标状态\npython scripts/jira_cli.py transition PROJ-123 --to \"Done\"\n```\n\n---\n\n## 六、常见问题\n\n| 现象 | 原因与解决 |\n| --- | --- |\n| `JIRA_URL and JIRA_TOKEN are required` | 未配置环境变量或配置文件 |\n| `HTTP 401` | token 失效或认证方式不匹配（Cloud 用 basic，Server PAT 用 bearer） |\n| `HTTP 403` | 账号没有对应项目/操作权限 |\n| `unsupported Jira version ...` | Jira Server/Data Center 版本低于 7.0，请升级 Jira 或使用旧版 skill |\n| `no transition \"Done\"` | 目标状态名不对，先用 `list-transitions` 查看准确名称 |\n| assign 在 Cloud 报错 | Cloud 较新版本需用 accountId，请用 Server 用户名或在 Cloud 用 accountId |\n\n---\n\n## 七、在 Claude / Claude Code 中使用\n\n将 `jira-skills` 目录放入 skills 目录后，直接用自然语言即可触发，例如：\n\n- “看下 PROJ-123 现在什么状态”\n- “在 PROJ 里建个 Bug，标题是登录接口 500”\n- “把 PROJ-123 流转到 Done”\n\nClaude 会自动调用本 skill 的对应命令。\n\n---\n\n## 八、技术支持与咨询\n\n如果在 Jira 工作流、权限、自动化、DevOps 平台或研发效能建设中遇到问题，欢迎联系\nRestartX 获取支持与方案咨询：https://service.restartx.top/\n\nFile v0.1.0:agents/openai.yaml\n\ninterface:\n  display_name: \"Jira DevOps\"\n  short_description: \"Jira issue and workflow operations\"\n  default_prompt: \"Use $jira-skills to inspect a Jira issue and recommend the next safe action.\"\n\npolicy:\n  allow_implicit_invocation: true\n\nFile v0.1.0:LICENSE\n\nMIT License\n\nCopyright (c) 2026 devops-skills contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nFile v0.1.0:requirements.txt\n\nrequests>=2.25,<3","readmeExcerpt":"Skill: Jira Skills Owner: weiguang1017 Summary: Jira issue and workflow operations Tags: latest:0.1.1 Version history: v0.1.1 | 2026-10-08T08:11:01.076Z | auto - Added detailed Chinese documentation and usage instructions to SKILL.md. - Moved full configuration and troubleshooting docs to new references/USAGE.md. - Removed outdated/duplicate documentation files (skill-card.md, 使用手册.md) for clarity. - Updated environm","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"export JIRA_URL=\"https://your-domain.atlassian.net\"\nexport JIRA_USER=\"you@example.com\"     # Cloud 用邮箱 / Server 用用户名\nexport JIRA_TOKEN=\"<api-token-or-PAT>\"\nexport JIRA_AUTH=\"basic\"               # Cloud 用 basic，Server/DC 的 PAT 用 bearer"},{"language":"bash","snippet":"PY=~/.workbuddy/binaries/python/envs/default/bin/python\n# 若报 Missing dependency，用同一个解释器装：\n# $PY -m pip install requests -i https://mirrors.aliyun.com/pypi/simple/"},{"language":"bash","snippet":"$PY scripts/jira_cli.py get-issue PROJ-123\n$PY scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\" --limit 20\n$PY scripts/jira_cli.py create-issue --project PROJ --type Bug --summary \"Login fails\" --description \"Steps...\"\n$PY scripts/jira_cli.py comment PROJ-123 --body \"Looking into this\"\n$PY scripts/jira_cli.py list-transitions PROJ-123\n$PY scripts/jira_cli.py transition PROJ-123 --to \"Done\"\n$PY scripts/jira_cli.py assign PROJ-123 --user jdoe"},{"language":"bash","snippet":"pip install requests\nexport JIRA_URL=\"https://your-jira.example.com\"\nexport JIRA_USER=\"you@example.com\"\nexport JIRA_TOKEN=\"<api-token-or-pat>\"\nexport JIRA_AUTH=\"basic\"  # Use bearer for a Server/DC PAT\n\npython scripts/jira_cli.py get-issue PROJ-123\npython scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\""},{"language":"bash","snippet":"pip install requests\nexport JIRA_URL=\"https://your-jira.example.com\"\nexport JIRA_USER=\"you@example.com\"\nexport JIRA_TOKEN=\"<api-token-or-pat>\"\nexport JIRA_AUTH=\"basic\"  # Server/DC PAT 使用 bearer\n\npython scripts/jira_cli.py get-issue PROJ-123\npython scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\""},{"language":"bash","snippet":"export JIRA_URL=\"https://your-domain.atlassian.net\"\nexport JIRA_USER=\"you@example.com\"      # bearer 模式可省略\nexport JIRA_TOKEN=\"你的token\"\nexport JIRA_AUTH=\"basic\"                # Cloud 用 basic；Server/DC PAT 用 bearer"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: jira-skills\ndescription: 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 查询、建缺陷/任务、加评论、流转状态、指派经办人。\n---\n\n# Jira 技能（命令行实操）\n\n通过 Jira REST API 操作单据，入口是单一自包含的 Python CLI：`scripts/jira_cli.py`。\n兼容 Jira Cloud、Server 与 Data Center。License: MIT。\n\n## 何时使用\n\n用户提出以下需求时调用本技能：\n\n- 查单据（\"看下 PROJ-123\"\"PROJ-45 现在什么状态\"）\n- 搜索（\"分配给我的未关闭缺陷\"，或任意 JQL）\n- 建单（\"在 PROJ 建一个任务，标题是……\"）\n- 评论、指派、按工作流流转（\"把 PROJ-12 置为完成\"）\n\n## 环境配置（首次）\n\n连接信息从环境变量读取，或放在配置文件 `~/.devops-skills/jira.json`。\n**禁止把 token 直接写在命令行参数里。**\n\n```bash\nexport JIRA_URL=\"https://your-domain.atlassian.net\"\nexport JIRA_USER=\"you@example.com\"     # Cloud 用邮箱 / Server 用用户名\nexport JIRA_TOKEN=\"<api-token-or-PAT>\"\nexport JIRA_AUTH=\"basic\"               # Cloud 用 basic，Server/DC 的 PAT 用 bearer\n```\n\n## 运行方式\n\n脚本依赖 `requests`。本机受管 Python 环境已安装（requests 2.34.2），**推荐直接用绝对路径调用**，\n避免默认的 `python3` 缺少依赖而失败：\n\n```bash\nPY=~/.workbuddy/binaries/python/envs/default/bin/python\n# 若报 Missing dependency，用同一个解释器装：\n# $PY -m pip install requests -i https://mirrors.aliyun.com/pypi/simple/\n```\n\n```bash\n$PY scripts/jira_cli.py get-issue PROJ-123\n$PY scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\" --limit 20\n$PY scripts/jira_cli.py create-issue --project PROJ --type Bug --summary \"Login fails\" --description \"Steps...\"\n$PY scripts/jira_cli.py comment PROJ-123 --body \"Looking into this\"\n$PY scripts/jira_cli.py list-transitions PROJ-123\n$PY scripts/jira_cli.py transition PROJ-123 --to \"Done\"\n$PY scripts/jira_cli.py assign PROJ-123 --user jdoe\n```\n\n所有命令把 JSON 打到 stdout，失败时以非零退出码结束。\n做状态流转时，**先 `list-transitions` 拿到合法目标状态名，再 `transition`**。\n\n## 兼容性\n\n- Jira Cloud\n- Jira Server / Data Center 7.0+\n\n执行命令前会请求 `/rest/api/2/serverInfo` 做版本校验，检测到 Server/DC 低于 7.0 会输出明确的兼容性提示并退出。\n确需绕过时可设 `JIRA_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。\n\n## 注意事项\n\n- Cloud 用「邮箱 + API Token」配 `JIRA_AUTH=basic`。\n- Server/DC 的 Personal Access Token 用 `JIRA_AUTH=bearer`（用户名可省略）。\n- `assign --user` 在 Server 用 `name`，Cloud 上可能需要 accountId。\n- 建单、评论、流转、指派都是写操作（🟡 级），执行前跟用户确认单据号与目标值。\n\n## 详细文档\n\n完整的配置方式、字段说明与排错见 `references/USAGE.md`。\n\n## 联系与支持\n\nJira 工作流、权限、自动化或研发交付流程问题需要人工支持时联系：\n📧 77890866@qq.com　|　🌐 https://www.restartx.top"},{"path":"README.md","content":"# Jira DevOps Skill\n\n[English](#english) | [中文](#chinese)\n\n<a id=\"english\"></a>\n## English\n\nManage Jira issues from the command line through the Jira REST API. The included\nPython CLI can read issues, run JQL searches, create issues, add comments, assign\nowners, and transition issues through a workflow.\n\n### Compatibility\n\n- Jira Cloud\n- Jira Server or Data Center 7.0+\n- Python 3.8+ and `requests`\n\nBefore normal execution, the CLI reads `/rest/api/2/serverInfo`. Server or Data\nCenter instances below 7.0 fail with a clear compatibility error. Do not bypass\nthe check unless compatibility has been independently verified.\n\n### Quick Start\n\n```bash\npip install requests\nexport JIRA_URL=\"https://your-jira.example.com\"\nexport JIRA_USER=\"you@example.com\"\nexport JIRA_TOKEN=\"<api-token-or-pat>\"\nexport JIRA_AUTH=\"basic\"  # Use bearer for a Server/DC PAT\n\npython scripts/jira_cli.py get-issue PROJ-123\npython scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\"\n```\n\nConnection settings can instead be stored in `~/.devops-skills/jira.json`.\nKeep that file outside version control and set its permissions to `600`.\n\n### Common Commands\n\n| Task | Command |\n| --- | --- |\n| Read an issue | `python scripts/jira_cli.py get-issue PROJ-123` |\n| Search with JQL | `python scripts/jira_cli.py search \"project = PROJ\" --limit 20` |\n| Create an issue | `python scripts/jira_cli.py create-issue --project PROJ --type Bug --summary \"Login fails\"` |\n| Add a comment | `python scripts/jira_cli.py comment PROJ-123 --body \"Investigating\"` |\n| List transitions | `python scripts/jira_cli.py list-transitions PROJ-123` |\n| Transition an issue | `python scripts/jira_cli.py transition PROJ-123 --to \"Done\"` |\n| Assign an owner | `python scripts/jira_cli.py assign PROJ-123 --user jdoe` |\n\n### Permissions and Safety\n\nRead operations need project browse and issue-view permissions. Grant create,\ncomment, assign, or transition permissions only when those actions are needed.\nThis skill does not need Jira global administration or permission-scheme\nadministration. Check available transitions before changing an issue state.\n\n### Documentation and Support\n\n- Agent instructions: [SKILL.md](./SKILL.md)\n- Detailed Chinese manual: [使用手册.md](./使用手册.md)\n- Support: https://service.restartx.top/\n\nFor Jira workflow, permissions, automation, DevOps platform, or engineering\nefficiency questions, RestartX provides technical support and implementation\nservices through the support address above.\n\n<a id=\"chinese\"></a>\n## 中文\n\n通过 Jira REST API 从命令行管理 Issue。内置 Python CLI 支持查看工单、JQL 搜索、创建\nIssue、添加评论、指派负责人和按工作流流转状态。\n\n### 兼容性\n\n- Jira Cloud\n- Jira Server 或 Data Center 7.0+\n- Python 3.8+ 与 `requests`\n\n脚本会在正常执行前请求 `/rest/api/2/serverInfo`。当 Server 或 Data Center 低于 7.0 时，\n会给出明确的不兼容错误并停止执行；除非已独立确认兼容性，否则不要跳过检查。\n\n### 快速开始\n\n```bash\npip install requests\nexport JIRA_URL=\"https://your-jira.example.com\"\nexport JIRA_USER=\"you@example.com\"\nexport JIRA_TOKEN=\"<api-token-or-pat>\"\nexport JIRA_AUTH=\"basic\"  # Server/DC PAT "},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7abv05p1jqkcnmnmkdpdex9581nt3f\",\n  \"slug\": \"jira-devops-skill\",\n  \"version\": \"0.1.1\",\n  \"publishedAt\": 1791447061076\n}"},{"path":"references/USAGE.md","content":"# Jira Skills 配置与使用手册\n\n通过一个零配置文件依赖的 Python CLI 操作 Jira，支持 Jira Cloud / Server / Data Center。\n\n---\n\n## 一、环境要求\n\n- Python 3.8 及以上\n- 安装依赖：`pip install requests`\n- Jira Cloud，或 Jira Server / Data Center 7.0 及以上\n\n脚本会在执行命令前通过 `/rest/api/2/serverInfo` 检测 Jira 版本；若自建 Jira\n版本低于 7.0，会直接给出明确的不兼容提示。确需跳过检查时，可设置\n`JIRA_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。\n\n---\n\n## 二、获取访问凭证\n\n### Jira Cloud（xxx.atlassian.net）\n1. 登录 Jira，访问 https://id.atlassian.com/manage-profile/security/api-tokens\n2. 点击 **Create API token**，复制生成的 token。\n3. 认证方式为 **basic**：用户名填你的登录邮箱，密码填该 token。\n\n### Jira Server / Data Center（自建）\n1. 头像 → **Personal Access Tokens** → **Create token**。\n2. 认证方式为 **bearer**：只需 token，无需用户名。\n\n---\n\n## 三、配置连接信息（二选一）\n\n### 方式 A：环境变量（推荐，适合临时/CI）\n\n```bash\nexport JIRA_URL=\"https://your-domain.atlassian.net\"\nexport JIRA_USER=\"you@example.com\"      # bearer 模式可省略\nexport JIRA_TOKEN=\"你的token\"\nexport JIRA_AUTH=\"basic\"                # Cloud 用 basic；Server/DC PAT 用 bearer\n```\n\n### 方式 B：配置文件（推荐，适合本地长期使用）\n\n创建 `~/.devops-skills/jira.json`：\n\n```json\n{\n  \"url\": \"https://your-domain.atlassian.net\",\n  \"user\": \"you@example.com\",\n  \"token\": \"你的token\",\n  \"auth\": \"basic\"\n}\n```\n\n> 安全建议：`chmod 600 ~/.devops-skills/jira.json`，切勿把 token 提交到仓库。\n\n---\n\n## 四、命令速查\n\n| 功能 | 命令 |\n| --- | --- |\n| 查看 issue | `python scripts/jira_cli.py get-issue PROJ-123` |\n| JQL 搜索 | `python scripts/jira_cli.py search \"project = PROJ AND status = 'In Progress'\" --limit 20` |\n| 创建 issue | `python scripts/jira_cli.py create-issue --project PROJ --type Bug --summary \"标题\" --description \"描述\"` |\n| 添加评论 | `python scripts/jira_cli.py comment PROJ-123 --body \"评论内容\"` |\n| 查看可用流转 | `python scripts/jira_cli.py list-transitions PROJ-123` |\n| 流转状态 | `python scripts/jira_cli.py transition PROJ-123 --to \"Done\"` |\n| 指派负责人 | `python scripts/jira_cli.py assign PROJ-123 --user jdoe` |\n\n---\n\n## 五、使用示例\n\n**1. 查看一个工单的状态**\n\n```bash\npython scripts/jira_cli.py get-issue PROJ-123\n```\n\n输出（JSON）：\n\n```json\n{\n  \"key\": \"PROJ-123\",\n  \"summary\": \"登录失败\",\n  \"status\": \"In Progress\",\n  \"assignee\": \"张三\",\n  \"type\": \"Bug\"\n}\n```\n\n**2. 创建一个 Bug 并指派**\n\n```bash\npython scripts/jira_cli.py create-issue \\\n  --project PROJ --type Bug \\\n  --summary \"登录接口 500\" \\\n  --description \"复现步骤：...\" \\\n  --assignee zhangsan\n```\n\n**3. 把工单流转到 Done（先查再转）**\n\n```bash\npython scripts/jira_cli.py list-transitions PROJ-123   # 先看有哪些目标状态\npython scripts/jira_cli.py transition PROJ-123 --to \"Done\"\n```\n\n---\n\n## 六、常见问题\n\n| 现象 | 原因与解决 |\n| --- | --- |\n| `JIRA_URL and JIRA_TOKEN are required` | 未配置环境变量或配置文件 |\n| `HTTP 401` | token 失效或认证方式不匹配（Cloud 用 basic，Server PAT 用 bearer） |\n| `HTTP 403` | 账号没有对应项目/操作权限 |\n| `unsupported Jira version ...` | Jira Server/Data Center 版本低于 7.0，请升级 Jira 或使用旧版 skill |\n| `no transition \"Done\"` | 目标状态名不对，先用 `list-transitions` 查看准确名称 |\n| assign 在 Cloud 报错 | Cloud 较新版本需用 accountId，请用 Server 用户名或在 Cloud 用 accountId |\n\n---\n\n## 七、在 Claude / Claude Code 中使用\n\n将 `jira-skills` 目录放入 skills 目录后，直接用自然语言即可触发，例如：\n\n- “看下 PROJ-123 现在什么状态”\n- “在 PROJ 里建个 Bug，标题是登录接口 500”"},{"path":"skill-card.md","content":"## Description:\n\nHelps agents read, search, create, comment on, assign, and transition Jira issues across Jira Cloud, Server, and Data Center.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[weiguang1017](https://clawhub.ai/user/weiguang1017)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nDevelopers and teams use this skill to inspect Jira issues, search with JQL, and manage issue creation, comments, assignments, and workflow transitions.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Write actions can change live Jira issues without a built-in confirmation gate, including after automatic invocation.\n\nMitigation: Before creating, commenting, assigning, or transitioning, show the exact issue key, operation, and target value and obtain user confirmation.\n\nRisk: Jira credentials can grant more access than the task requires or be exposed if stored insecurely.\n\nMitigation: Use an account with only the needed project permissions; keep tokens in environment variables or a protected config file outside version control.\n\n## Reference(s):\n\n- [Source repository (server-resolved provenance)](https://github.com/weiguang1017/jira-devops-skill)\n- [ClawHub skill release](https://clawhub.ai/weiguang1017/skills/jira-devops-skill)\n- [Jira Skills usage guide](references/USAGE.md)\n\n## Skill Output:\n\n**Output Type(s):** [Guidance, Shell commands, Text]\n\n**Output Format:** [Markdown guidance and JSON command results]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Command results vary by operation; errors return a nonzero exit status.]\n\n## Skill Version(s):\n\n0.1.1 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1332,"uniquenessScore":44,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T13:53:24.955Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T13:53:24.955Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T21:12:35.433Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}