Agent skill

Jira Integration

by affaan-m in affaan-m/ECC

在检索Jira工单、分析需求、更新工单状态、添加评论或转换问题时使用此技能。通过MCP或直接REST调用提供Jira API模式。

MITAuto-check: notesBackend & APIs

Install Jira Integration

skills CLI
$ npx skills add affaan-m/ECC --skill jira-integration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install affaan-m/ECC jira-integration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/zh-CN/skills/jira-integration .claude/skills/jira-integration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
jira-integration
GitHub stars
276k
Token cost
~1.5k tokens
SKILL.md length
316 words
Files
1
Skills in repo
683
Repo updated
First seen
Licence
MIT

At a glance

在检索Jira工单、分析需求、更新工单状态、添加评论或转换问题时使用此技能。通过MCP或直接REST调用提供Jira API模式。

  • Works in 4 steps: 可测试的需求 → 所需的测试类型 → 边界情况与错误场景 → …
  • Tasks that involve MCP servers
  • SKILL.md covers 何时激活, 前提条件, MCP 工具参考 and 直接 REST API 参考, plus 5 more sections
  • Calls jq and curl; reaches github.com; needs JIRA_API_TOKEN

What it does

Jira Integration is an agent skill from affaan-m/ECC. 在检索Jira工单、分析需求、更新工单状态、添加评论或转换问题时使用此技能。通过MCP或直接REST调用提供Jira API模式。

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering MCP servers. It works with Jira and Model Context Protocol. The repository describes itself as: The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. The licence is MIT.

When your agent uses it

  • Tasks that involve MCP servers

Example prompts

  • “/jira-integration”

Requirements

  • Python 3
  • A credential in JIRA_API_TOKEN

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. 可测试的需求
  2. 所需的测试类型
  3. 边界情况与错误场景
  4. 结构化分析输出

What it can do on your machine

Read from SKILL.md and the folder at commit 4eb71d9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    Also links to:

    • id.atlassian.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • JIRA_API_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Jira Integration loads about 1.5k tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 316 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~21
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:289
    * **将 `.env`** 添加到每个项目的 `.gitignore` 中

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from affaan-m/ECC at commit 4eb71d9, republished under its MIT licence (© affaan-m). 316 words, ~1,453 tokens.

Download SKILL.mdSave it as .claude/skills/jira-integration/SKILL.md (or your agent's skills folder).
name
jira-integration
description
在检索Jira工单、分析需求、更新工单状态、添加评论或转换问题时使用此技能。通过MCP或直接REST调用提供Jira API模式。
origin
ECC

Jira 集成技能

直接从 AI 编码工作流中检索、分析和更新 Jira 工单。支持 基于 MCP(推荐)和 直接 REST API 两种方式。

何时激活

  • 获取 Jira 工单以理解需求
  • 从工单中提取可测试的验收标准
  • 向 Jira 问题添加进度评论
  • 转换工单状态(待办 → 进行中 → 完成)
  • 将合并请求或分支链接到 Jira 问题
  • 通过 JQL 查询搜索问题

前提条件

选项 A:MCP 服务器(推荐)

安装 mcp-atlassian MCP 服务器。这将向您的 AI 代理直接暴露 Jira 工具。

要求:

  • Python 3.10+
  • uvx(来自 uv),通过您的包管理器或官方 uv 安装文档进行安装

添加到您的 MCP 配置(例如,~/.claude.json → mcpServers):

json
{
  "jira": {
    "command": "uvx",
    "args": ["mcp-atlassian==0.21.0"],
    "env": {
      "JIRA_URL": "https://YOUR_ORG.atlassian.net",
      "JIRA_EMAIL": "your.email@example.com",
      "JIRA_API_TOKEN": "your-api-token"
    },
    "description": "Jira issue tracking — search, create, update, comment, transition"
  }
}

安全: 切勿在源代码中硬编码密钥。建议在系统环境(或密钥管理器)中设置 JIRA_URL、JIRA_EMAIL 和 JIRA_API_TOKEN。仅对本地未提交的配置文件使用 MCP env 块。

获取 Jira API 令牌:

  1. 访问 https://id.atlassian.com/manage-profile/security/api-tokens
  2. 点击 创建 API 令牌
  3. 复制令牌 — 将其存储在您的环境中,切勿存储在源代码中
选项 B:直接 REST API

如果 MCP 不可用,可通过 curl 或辅助脚本直接使用 Jira REST API v3。

所需的环境变量:

变量描述
JIRA_URL您的 Jira 实例 URL(例如,https://yourorg.atlassian.net)
JIRA_EMAIL您的 Atlassian 账户邮箱
JIRA_API_TOKEN来自 id.atlassian.com 的 API 令牌

将这些存储在您的 shell 环境、密钥管理器或未跟踪的本地环境文件中。不要将其提交到仓库。

对于直接 curl 示例,请通过标准输入传递 Jira 用户配置,避免凭据出现在命令行参数中。

bash
jira_curl() {
  printf 'user = "%s:%s"\n' "$JIRA_EMAIL" "$JIRA_API_TOKEN" |
    curl -s -K - "$@"
}

MCP 工具参考

当配置了 mcp-atlassian MCP 服务器时,以下工具可用:

工具用途示例
jira_searchJQL 查询project = PROJ AND status = "In Progress"
jira_get_issue按键获取完整问题详情PROJ-1234
jira_create_issue创建问题(任务、缺陷、故事、史诗)新建缺陷报告
jira_update_issue更新字段(摘要、描述、经办人)更改经办人
jira_transition_issue更改状态移至“评审中”
jira_add_comment添加评论进度更新
jira_get_sprint_issues列出冲刺中的问题活跃冲刺评审
jira_create_issue_link链接问题(阻塞、关联)依赖跟踪
jira_get_issue_development_info查看关联的 PR、分支、提交开发上下文

提示: 在转换前始终调用 jira_get_transitions — 转换 ID 因项目工作流而异。

直接 REST API 参考

获取工单
bash
jira_curl \
  -H "Content-Type: application/json" \
  "$JIRA_URL/rest/api/3/issue/PROJ-1234" | jq '{
    key: .key,
    summary: .fields.summary,
    status: .fields.status.name,
    priority: .fields.priority.name,
    type: .fields.issuetype.name,
    assignee: .fields.assignee.displayName,
    labels: .fields.labels,
    description: .fields.description
  }'
获取评论
bash
jira_curl \
  -H "Content-Type: application/json" \
  "$JIRA_URL/rest/api/3/issue/PROJ-1234?fields=comment" | jq '.fields.comment.comments[] | {
    author: .author.displayName,
    created: .created[:10],
    body: .body
  }'
添加评论
bash
jira_curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "body": {
      "version": 1,
      "type": "doc",
      "content": [{
        "type": "paragraph",
        "content": [{"type": "text", "text": "Your comment here"}]
      }]
    }
  }' \
  "$JIRA_URL/rest/api/3/issue/PROJ-1234/comment"
转换工单
bash
# 1. Get available transitions
jira_curl \
  "$JIRA_URL/rest/api/3/issue/PROJ-1234/transitions" | jq '.transitions[] | {id, name: .name}'

# 2. Execute transition (replace TRANSITION_ID)
jira_curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"transition": {"id": "TRANSITION_ID"}}' \
  "$JIRA_URL/rest/api/3/issue/PROJ-1234/transitions"
使用 JQL 搜索
bash
jira_curl -G \
  --data-urlencode "jql=project = PROJ AND status = 'In Progress'" \
  "$JIRA_URL/rest/api/3/search"

分析工单

当为开发或测试自动化检索工单时,提取:

1. 可测试的需求
  • 功能需求 — 功能的作用
  • 验收标准 — 必须满足的条件
  • 可测试的行为 — 具体操作和预期结果
  • 用户角色 — 谁使用此功能及其权限
  • 数据需求 — 需要哪些数据
  • 集成点 — 涉及的 API、服务或系统
2. 所需的测试类型
  • 单元测试 — 单个函数和工具
  • 集成测试 — API 端点和服务交互
  • 端到端测试 — 面向用户的 UI 流程
  • API 测试 — 端点契约和错误处理
3. 边界情况与错误场景
  • 无效输入(空值、过长、特殊字符)
  • 未授权访问
  • 网络故障或超时
  • 并发用户或竞态条件
  • 边界条件
  • 数据缺失或为空
  • 状态转换(返回导航、刷新等)
4. 结构化分析输出
Ticket: PROJ-1234
Summary: [工单标题]
Status: [当前状态]
Priority: [高/中/低]
Test Types: 单元测试, 集成测试, 端到端测试

Requirements:
1. [需求1]
2. [需求2]

Acceptance Criteria:
- [ ] [验收标准1]
- [ ] [验收标准2]

Test Scenarios:
- Happy Path: [描述]
- Error Case: [描述]
- Edge Case: [描述]

Test Data Needed:
- [测试数据1]
- [测试数据2]

Dependencies:
- [依赖项1]
- [依赖项2]

更新工单

何时更新
工作流步骤Jira 更新
开始工作转换为“进行中”
编写测试评论并附上测试覆盖率摘要
创建分支评论并附上分支名称
创建 PR/MR评论并附上链接,链接问题
测试通过评论并附上结果摘要
PR/MR 合并转换为“完成”或“评审中”
评论模板

开始工作:

开始实现此工单。
分支:feat/PROJ-1234-feature-name

测试已实现:

已实现的自动化测试:

单元测试:
- [测试文件1] — [覆盖内容]
- [测试文件2] — [覆盖内容]

集成测试:
- [测试文件] — [覆盖的端点/流程]

所有测试在本地通过。覆盖率:XX%

PR 已创建:

Pull request created:
[PR Title](https://github.com/org/repo/pull/XXX)

Ready for review.

工作完成:

Implementation complete.

PR merged: [link]
Test results: All passing (X/Y)
Coverage: XX%

安全指南

  • 切勿在源代码或技能文件中硬编码 Jira API 令牌
  • 始终使用环境变量或密钥管理器
  • 将 .env 添加到每个项目的 .gitignore 中
  • 如果令牌暴露在 git 历史中,立即轮换
  • 使用最小权限 API 令牌,范围限定在所需项目
  • 在发出 API 调用前验证凭据是否已设置 — 快速失败并给出清晰消息

故障排除

错误原因修复
401 UnauthorizedAPI 令牌无效或已过期在 id.atlassian.com 重新生成
403 Forbidden令牌缺少项目权限检查令牌范围和项目访问权限
404 Not Found工单键或基础 URL 错误验证 JIRA_URL 和工单键
spawn uvx ENOENTIDE 在 PATH 中找不到 uvx使用完整路径(例如,~/.local/bin/uvx)或在 ~/.zprofile 中设置 PATH
连接超时网络/VPN 问题检查 VPN 连接和防火墙规则

最佳实践

  • 边工作边更新 Jira,而不是最后一次性更新
  • 保持评论简洁但信息丰富
  • 链接而非复制 — 指向 PR、测试报告和仪表板
  • 如果需要他人输入,使用 @提及
  • 在开始前检查关联问题以了解完整功能范围
  • 如果验收标准模糊,在编写代码前要求澄清

© affaan-m, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in docs/zh-CN/skills/jira-integration of affaan-m/ECC.

Open the folder on GitHubat commit 4eb71d9

Compare with similar skills

Jira Integration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Jira Integration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Jira Integration this skillaffaan-m/ECC276k—~1.5kAutomated safety check: NotesMIT
Atlassian MCP ExpertJeffallan/claude-skills12k—~1.3kAutomated safety check: PassMIT
Atlassiansanjay3290/ai-skills432—~1.6kAutomated safety check: PassApache-2.0
Jira Natural Language Interfacejjmartres/opencode1333 repos~1.7kAutomated safety check: PassMIT
Work Items To Jiratestdouble/han281—~4.3kAutomated safety check: PassMIT
Markdown To Confluencetestdouble/han281—~2.4kAutomated safety check: PassMIT

Similar skills

  • Atlassian MCP Expert

    Jeffallan/claude-skills

    Queries and edits Jira issues and Confluence pages through an MCP server, covering JQL and CQL queries, server setup, authentication and sprint or backlog workflows.

    12k GitHub stars~1.3k tokensUpdated 7 days ago
    Backend & APIsAuto-check passed
  • Atlassian

    sanjay3290/ai-skills

    Manage Jira issues and Confluence wiki pages in Atlassian Cloud.

    432 GitHub stars~1.6k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Lets an agent view, create, update and transition Jira issues in natural language, automatically choosing between the jira CLI and Atlassian MCP tools.

    133 GitHub starsUsed in 3 repos~1.7k tokens
    Product & Project ManagementAuto-check passed
  • Work Items To Jira

    testdouble/han

    Break a work-items.md file (produced by /plan-work-items) into independently-grabbable Jira tickets, one per slice, in a single Jira project.

    281 GitHub stars~4.3k tokensUpdated 10 days ago
    Agent WorkflowsAuto-check passed
  • Publishes a local Markdown file to a user-specified Confluence location, creating a new page or updating an existing one through the Atlassian MCP server.

    281 GitHub stars~2.4k tokensUpdated 10 days ago
    Documents & OfficeAuto-check passed
  • MCP Atlassian

    sundial-org/awesome-openclaw-skills

    Run the Model Context Protocol (MCP) Atlassian server in Docker, enabling integration with Jira, Confluence, and other Atlassian products.

    663 GitHub stars~433 tokensUpdated 7 mo ago
    Agent WorkflowsAuto-check passed

More from affaan-m/ECC

All 682 skills in this repo
  • Skill Stocktake

    affaan-m/ECC

    Audits your installed Claude skills and commands for quality, with a quick mode for recently changed skills and a full mode that evaluates all of them through subagents.

    277k GitHub starsUsed in 5 repos~3.1k tokens
    Auto-check passed
  • Ingests, indexes, searches, edits and monitors video, audio and live streams through the VideoDB Python SDK, returning stream links, clips and timestamps.

    277k GitHub starsUsed in 3 repos~3.5k tokens
    Auto-check: notes
  • Docs Governance

    affaan-m/ECC

    Route broad documentation-governance requests to existing ECC skills and run an opt-in, read-only audit of mapped documentation roles, links, ADR indexes, and evidence references.

    277k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Rules Distillation

    affaan-m/ECC

    Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.

    277k GitHub starsUsed in 2 repos~2.3k tokens
    Auto-check passed
  • Builds DRAFT counterparty agreements from one markdown template and a small JSON spec per party, with clauses picked by the party's role.

    277k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Set an ECC-specific frontend design direction for production UI work.

    277k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

Categories

Questions about Jira Integration

What does Jira Integration do?

在检索Jira工单、分析需求、更新工单状态、添加评论或转换问题时使用此技能。通过MCP或直接REST调用提供Jira API模式。. Jira Integration is an agent skill from affaan-m/ECC.

When should I use Jira Integration?

Jira Integration fits situations like: tasks that involve MCP servers.

How do I install Jira Integration in Claude Code?

Run `npx skills add affaan-m/ECC --skill jira-integration -a claude-code`. Or copy the skill folder (docs/zh-CN/skills/jira-integration in affaan-m/ECC) into .claude/skills/jira-integration in your project. Claude Code loads it when a task matches its description.

How do I install Jira Integration in Codex?

Run `npx skills add affaan-m/ECC --skill jira-integration -a codex`. Or copy the skill folder (docs/zh-CN/skills/jira-integration in affaan-m/ECC) into .agents/skills/jira-integration in your project. Codex loads it when a task matches its description.

Can I use Jira Integration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add affaan-m/ECC --skill jira-integration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/jira-integration, .gemini/skills/jira-integration, .github/skills/jira-integration and .opencode/skills/jira-integration in your project.

What does Jira Integration need to run?

Going by SKILL.md and its folder, Jira Integration needs the command-line tools its instructions call (jq and curl) and credentials named JIRA_API_TOKEN. Our summary lists: Python 3; A credential in JIRA_API_TOKEN.

Does Jira Integration access the network?

SKILL.md names 2 domains. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. As links in the text: id.atlassian.com. This is read from the text; nothing was executed.

Is Jira Integration safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Jira Integration use?

Jira Integration is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Jira Integration use?

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Jira Integration?

Skills that share tags, products or a category with Jira Integration: Atlassian MCP Expert (Jeffallan/claude-skills, 12k stars), Atlassian (sanjay3290/ai-skills, 432 stars), Jira Natural Language Interface (jjmartres/opencode, 133 stars) and Work Items To Jira (testdouble/han, 281 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Jira Integration?

affaan-m (a GitHub user) maintains it in affaan-m/ECC, which has 276,111 GitHub stars. The repository holds 683 skills in this directory. The repository was last updated on October 10, 2026.

Source: affaan-m/ECC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.