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 interactions not covered in public documentation.
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--c27c83