jira-integration

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

Repository: affaan-m/ECC
Last source activity: June 7, 2026 at 05:25
Detected SKILL.md language: Chinese
Stars: 246,148
Forks: 37,131

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/affaan-m/ECC --skill jira-integration

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

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）：

{
  "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 令牌：

访问 https://id.atlassian.com/manage-profile/security/api-tokens
点击 创建 API 令牌
复制令牌 — 将其存储在您的环境中，切勿存储在源代码中

选项 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 用户配置，避免凭据出现在命令行参数中。

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

MCP 工具参考

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

工具	用途	示例
`jira_search`	JQL 查询	`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 参考

获取工单

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
  }'

获取评论

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
  }'

添加评论

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"

转换工单

# 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 搜索

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 Unauthorized`	API 令牌无效或已过期	在 id.atlassian.com 重新生成
`403 Forbidden`	令牌缺少项目权限	检查令牌范围和项目访问权限
`404 Not Found`	工单键或基础 URL 错误	验证 `JIRA_URL` 和工单键
`spawn uvx ENOENT`	IDE 在 PATH 中找不到 `uvx`	使用完整路径（例如，`~/.local/bin/uvx`）或在 `~/.zprofile` 中设置 PATH
连接超时	网络/VPN 问题	检查 VPN 连接和防火墙规则

最佳实践

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

jira-integration

Source facts

Install options

Review the source files

More from this repository

Jira 集成技能

何时激活

前提条件

选项 A：MCP 服务器（推荐）

选项 B：直接 REST API

MCP 工具参考

直接 REST API 参考

获取工单

获取评论

添加评论

转换工单

使用 JQL 搜索

分析工单

1. 可测试的需求

2. 所需的测试类型

3. 边界情况与错误场景

4. 结构化分析输出

更新工单

何时更新

评论模板

安全指南

故障排除

最佳实践

Jira 集成技能

何时激活

前提条件

选项 A：MCP 服务器（推荐）

选项 B：直接 REST API

MCP 工具参考

直接 REST API 参考

获取工单

获取评论

添加评论

转换工单

使用 JQL 搜索

分析工单

1. 可测试的需求

2. 所需的测试类型

3. 边界情况与错误场景

4. 结构化分析输出

更新工单

何时更新

评论模板

安全指南

故障排除

最佳实践

More from this repository