Agent skill · software engineering · affaan-m
jira-integration
在检索Jira工单、分析需求、更新工单状态、添加评论或转换问题时使用此技能。通过MCP或直接REST调用提供Jira API模式。
Why this skill is useful
Adds executable scripts for Jira issue management that automate workflows and integrate with the Jira API, which the AI cannot generate on its own.
What it needs
Requires mcp-atlassian, uv installed locally. Requires atlassian account access. About 3k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
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）： 安全： 切勿在源代码中硬编码密钥。建议在系统环境（或密钥管理器）中设置 JIRAURL、JIRAEMAIL 和 JIRAAPITOKEN。仅对本地未提交的配置文件使用 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。 所需的环境变量： 变量 描述 ---------- ------------- JIRAURL 您的 Jira 实例 URL（例如，https://yourorg.atlassian.net） JIRAEMAIL 您的 Atlassian 账户邮箱 JIRAAPITOKEN 来自 id.atlassian.com 的 API 令牌 将这些存储在您的 shell 环境、密钥管理器或未跟踪的本地环境文件中。不要将其提交到仓库。 对于直接 curl 示例，请通过标准输入传递 Jira 用户配置，避免凭据出现在命令行参数中。 MCP 工具参考 当配置了 mcp-atlassian MCP 服务器时，以下工具可用： 工具 用途 示例 ------ --------- --------- jirasearch JQL 查询 project = PROJ AND status = "In Progress" jiragetissue 按键获取完整问题详情 PROJ-1234 jiracreateissue 创建问题（任务、缺陷、故事、史诗） 新建缺陷报告 jiraupdateissue 更新字段（摘要、描述、经办人） 更改经办人 jiratransitionissue 更改状态 移至“评审中” jiraaddcomment 添加评论 进度更新 jiragetsprintissues 列出冲刺中的问题 活跃冲刺评审 jiracreateissuelink 链接问题（阻塞、关联） 依赖跟踪 jiragetissuedevelopmentinfo 查看关联的 PR、分支、提交 开发上下文 提示： 在转换前始终调用 jiragettransitions — 转换 ID 因项目工作流而异。 直接 REST API 参考 获取工单 获取评论 添加评论 转换工单 使用 JQL 搜索 分析工单 当为开发或测试自动化检索工单时，提取： 1. 可测试的需求 功能需求 — 功能的作用 验收标准 — 必须满足的条件 可测试的行为 — 具体操作和预期结果 用户角色 — 谁使用此功能及其权限 数据需求 — 需要哪些数据 集成点 — 涉及的 API、服务或系统 2. 所需的测试类型 单元测试 — 单个函数和工具 集成测试 — API 端点和服务交互 端到端测试 — 面向用户的 UI 流程 API 测试 — 端点契约和错误处理 3. 边界情况与错误场景 无效输入（空值、过长、特殊字符） 未授权访问 网络故障或超时 并发用户或竞态条件 边界条件 数据缺失或为空 状态转换（返回导航、刷新等） 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/jira-integration--14f9fb