Jira 说明文档

# Jira 技能 通过自然语言与 Jira 进行交互，以管理工单、冲刺和工作流。此技能使 Claude 能够使用对话命令查看、创建、更新和转换 Jira 工单。 ## 目的 Jira 技能弥合了自然语言请求与 Jira 操作之间的鸿沟。无需记忆特定的 CLI 命令或 API 调用，您只需告诉 Claude 您想对 Jira 工单执行的操作，该技能即可处理技术细节。 主要优势： - **对话式界面**：询问诸如“我有哪些待处理的工单？”或“将 PROJ-123 移动到已完成”之类的问题 - **双后端支持**：支持 jira CLI 或 Atlassian MCP - **安全优先方法**：在修改前始终获取当前状态，并要求对更改进行确认 - **上下文感知**：在对话中检测工单键（例如 PROJ-123）并提供相关操作 ## 何时使用 在以下情况激活此技能： - 提到 Jira 工单键（例如，“显示 PROJ-123”，“ABC-456 的状态是什么？”） - 询问工单（“列出我待处理的工单”，“分配给我的任务是什么？”） - 想要创建工单（“为登录问题创建一个 Bug 工单”） - 需要更新工单（“将其移动到进行中”，“将 PROJ-123 分配给我”） - 检查冲刺状态（“当前冲刺中有什么？”，“显示冲刺待办事项”） - 管理工作流（“关闭此工单”，“给 PROJ-123 添加评论”） **触发短语包括：** - “create a jira ticket”（创建 jira 工单） - “show me PROJ-123”（显示 PROJ-123） - “list my tickets”（列出我的工单） - “move ticket to done”（将工单移动到已完成） - “what's in the current sprint”（当前冲刺中有什么） - 任何提到 “jira”、“issue”（工单）、“ticket”（工单）、“sprint”（冲刺）或 “backlog”（待办事项）的内容 ## 工作原理 ### 1. 后端检测 激活后，该技能首先确定可用的后端： 1. **CLI 后端**：检查是否安装了 `jira` 命令 2. **MCP 后端**：查找 Atlassian MCP 工具 (`mcp__atlassian__*`) 3. **无后端**：引导您安装上述其中之一 ### 2. 操作执行 一旦检测到后端： 1. **读取操作**（查看、列出）：立即执行并显示结果 2. **写入操作**（创建、更新、转换）： - 首先获取当前工单状态 - 显示建议的更改 - 请求用户批准 - 执行操作 - 验证结果 ### 3. 安全检查 在进行任何修改之前，该技能会： - 获取当前工单状态（从不假设状态或指派人） - 检查可能受影响的其他人员（关注者、关联工单） - 验证操作是否可逆，如果不可逆则发出警告