mcpField
J
jira

jira

github.com/softaworks生产力2.6k834 次安装34 周前更新
代码仓库

关于 jira

这项 Skill 将自然语言请求用于 Jira 操作，并在可用时选择 Jira CLI 或 Atlassian MCP 工具。它支持查询和修改事项，并要求在变更前获得批准。

主要功能

  1. 01检测可用的 CLI 或 MCP 后端
  2. 02查看、搜索和创建事项
  3. 03更新状态、经办人和评论
  4. 04变更前检查事项状态
  5. 05修改前请求批准

适用场景

  1. 01查看事项详情或状态
  2. 02列出分配的事项或 Sprint 事项
  3. 03创建经审核的 Jira 事项
  4. 04经批准后更新事项

MCP 相关

有 Atlassian MCP 工具时，该 Skill 会将其用作 Jira 后端。它可通过这些工具搜索、获取、创建、编辑和转换 Jira 事项状态，并添加评论。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/softaworks/agent-toolkit --skill jira

安装后在 Claude Code 中输入/jira确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
references/
commands.md
mcp.md

详细介绍

Jira

通过自然语言与 Jira 交互。支持多个后端。

后端检测

先运行此检查，以确定要使用哪个后端：

1. Check if jira CLI is available:
   → Run: which jira
   → If found: USE CLI BACKEND

2. If no CLI, check for Atlassian MCP:
   → Look for mcp__atlassian__* tools
   → If available: USE MCP BACKEND

3. If neither available:
   → GUIDE USER TO SETUP
后端使用时机参考
CLIjira 命令可用references/commands.md
MCPAtlassian MCP 工具可用references/mcp.md
None两者均不可用指引安装 CLI

快速参考（CLI）

使用 MCP 后端时跳过此部分。

意图命令
查看问题jira issue view ISSUE-KEY
列出我的问题jira issue list -a$(jira me)
我的进行中问题jira issue list -a$(jira me) -s"In Progress"
创建问题jira issue create -tType -s"Summary" -b"Description"
移动／转换状态jira issue move ISSUE-KEY "State"
分配给我jira issue assign ISSUE-KEY $(jira me)
取消分配jira issue assign ISSUE-KEY x
添加评论jira issue comment add ISSUE-KEY -b"Comment text"
在浏览器中打开jira open ISSUE-KEY
当前冲刺jira sprint list --state active
我是谁jira me

快速参考（MCP）

使用 CLI 后端时跳过此部分。

意图MCP 工具
搜索问题mcp__atlassian__searchJiraIssuesUsingJql
查看问题mcp__atlassian__getJiraIssue
创建问题mcp__atlassian__createJiraIssue
更新问题mcp__atlassian__editJiraIssue
获取转换状态mcp__atlassian__getTransitionsForJiraIssue
转换状态mcp__atlassian__transitionJiraIssue
添加评论mcp__atlassian__addCommentToJiraIssue
查询用户mcp__atlassian__lookupJiraAccountId
列出项目mcp__atlassian__getVisibleJiraProjects

完整的 MCP 用法请参阅 references/mcp.md。

触发语句

  • “创建 Jira 工单”
  • “给我看看 PROJ-123”
  • “列出我的工单”
  • “将工单移至已完成”
  • “当前冲刺中有哪些内容”

问题键检测

问题键遵循以下格式：[A-Z]+-[0-9]+（例如，PROJ-123、ABC-1）。

当用户在对话中提及问题键时：

  • CLI： jira issue view KEY 或 jira open KEY
  • MCP： 使用问题键调用 mcp__atlassian__jira_get_issue

工作流

创建工单：

  1. 如果用户提到了代码、工单或 PR，先调研相关背景
  2. 起草工单内容
  3. 与用户确认
  4. 使用适当的后端创建工单

更新工单：

  1. 先获取问题详情
  2. 检查状态（对进行中的工单要谨慎）
  3. 展示当前内容与拟议更改
  4. 更新前获得批准
  5. 添加评论说明更改内容

执行任何操作前

先问自己：

  1. 当前状态是什么？ — 始终先获取问题信息。不要假设状态、经办人或字段与用户认为的一致。

  2. 还会影响谁？ — 检查关注者、关联问题和父级史诗。“简单编辑”也可能通知 10 个人。

  3. 此操作可撤销吗？ — 状态转换可能设有单向关卡。某些工作流需要经过中间状态。描述编辑无法撤销。

  4. 标识符是否正确？ — 检查问题键、转换 ID 和账户 ID。分配时不能使用显示名称（MCP）。

绝不

  • 绝不在获取当前状态前进行转换 — 工作流可能要求先经过中间状态。从“To Do”直接转到“Done”可能会在需要先转到“In Progress”时静默失败。

  • 绝不使用显示名称进行分配（MCP） — 只有账户 ID 才有效。务必先调用 lookupJiraAccountId，否则分配会静默失败。

  • 绝不在展示原始内容前编辑描述 — Jira 不支持撤销。用户必须先看到将要替换的内容。

  • 绝不在未填写所有必填字段时使用 --no-input（CLI） — 这会静默失败，并显示含糊的错误。请先检查项目的必填字段。

  • 绝不假设转换名称通用 — “Done”、“Closed”和“Complete”会因项目而异。务必先获取可用的转换。

  • 绝不在未经明确批准的情况下批量修改 — 每次更改工单都会通知关注者。修改 10 项 = 发送 10 轮通知。

安全

  • 执行前务必展示命令／工具调用
  • 修改工单前务必征得批准
  • 编辑时保留原始信息
  • 应用更改后务必验证
  • 务必清楚说明身份验证问题，以便用户解决

没有可用的后端

如果 CLI 和 MCP 都不可用，请引导用户：

To use Jira, you need one of:

1. **jira CLI** (recommended):
   https://github.com/ankitpokhrel/jira-cli

   Install: brew install ankitpokhrel/jira-cli/jira-cli
   Setup:   jira init

2. **Atlassian MCP**:
   Configure in your MCP settings with Atlassian credentials.

深入了解

在以下情况下加载参考资料：

  • 创建带有复杂字段或多行内容的问题
  • 构建超出简单筛选范围的 JQL 查询
  • 排查错误或身份验证问题
  • 处理状态转换、关联或冲刺

在以下情况下不要加载参考资料：

  • 简单的查看／列表操作（上方的快速参考已足够）
  • 基本状态检查（jira issue view KEY）
  • 在浏览器中打开问题
任务是否加载参考资料？
查看单个问题否
列出我的工单否
创建带描述的问题是 — CLI 需要 /tmp 模式
转换问题状态是 — 需要转换 ID 工作流
JQL 搜索是 — 用于复杂查询
关联问题是 — MCP 有限制，需要使用脚本

参考资料：

  • CLI 模式：references/commands.md
  • MCP 模式：references/mcp.md

评论

支持 Markdown