名称： jira
描述： 当用户提及 Jira 问题（例如 "PROJ-123"）、询问工单、希望创建/查看/更新问题、检查冲刺状态或管理其 Jira 工作流时使用。触发关键词包括 "jira"、"issue"、"ticket"、"sprint"、"backlog" 或问题键模式。
元数据：
{
"openclaw":
{
"emoji": "🎫",
"requires":
{
"anyBins": ["jira"],
"env": ["JIRA_API_TOKEN"],
},
},
}

Jira

与 Jira 的自然语言交互。支持多种后端。

后端检测

首先执行此检查以确定使用哪个后端：

1. 检查 jira CLI 是否可用：
   → 运行：which jira
   → 如果找到：使用 CLI 后端

2. 如果没有 CLI，检查 Atlassian MCP：
   → 查找 mcp__atlassian__* 工具
   → 如果可用：使用 MCP 后端

3. 如果两者都不可用：
   → 引导用户进行设置

快速参考 (CLI)

如果使用 MCP 后端，请跳过此部分。

快速参考 (MCP)

如果使用 CLI 后端，请跳过此部分。

完整 MCP 模式请参见 references/mcp.md。

触发词

• "create a jira ticket"（创建一个 Jira 工单）
• "show me PROJ-123"（给我看 PROJ-123）
• "list my tickets"（列出我的工单）
• "move ticket to done"（将工单移到完成）
• "what's in the current sprint"（当前冲刺里有什么）

问题键检测

问题键遵循模式：[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）。

绝对禁止

• 绝对禁止在不获取当前状态的情况下进行状态转换 — 工作流可能需要中间状态。"待办" → "完成" 如果必须先到"进行中"，可能会静默失败。
• 绝对禁止使用显示名称进行分配（MCP） — 只有账户 ID 有效。始终先调用 lookupJiraAccountId，否则分配会静默失败。
• 绝对禁止在不显示原文的情况下编辑描述 — Jira 没有撤销功能。用户必须看到他们替换的内容。
• 绝对禁止在未提供所有必填字段的情况下使用 --no-input（CLI） — 会静默失败并出现神秘错误。先检查项目的必填字段。
• 绝对禁止假设状态转换名称是通用的 — "完成"、"已关闭"、"已完成" 因项目而异。始终先获取可用的转换。
• 绝对禁止未经明确批准进行批量修改 — 每个工单变更都会通知关注者。10 次编辑 = 10 次通知风暴。

安全准则

• 始终在运行前显示命令/工具调用
• 始终在修改工单前获得批准
• 编辑时保留原始信息
• 应用更新后进行验证
• 始终清晰地呈现身份验证问题，以便用户解决

无可用后端

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

要使用 Jira，您需要以下之一：

1.  **jira CLI**（推荐）：
    https://github.com/ankitpokhrel/jira-cli

    安装：brew install ankitpokhrel/jira-cli/jira-cli
    设置：   jira init

2.  **Atlassian MCP**：
    在您的 MCP 设置中使用 Atlassian 凭据进行配置。

深入探讨

在以下情况时加载参考文档：
- 创建具有复杂字段或多行内容的问题
- 构建超出简单筛选器的 JQL 查询
- 排查错误或身份验证问题
- 处理状态转换、链接或冲刺

以下情况无需加载参考文档：
- 简单的查看/列表操作（上面的快速参考已足够）
- 基本状态检查（jira issue view KEY）
- 在浏览器中打开问题

参考文档：
- CLI 模式：references/commands.md
- MCP 模式：references/mcp.md