JIRA

核心功能

Jira Skill 提供自然语言驱动的Jira项目管理能力，覆盖Issue全生命周期操作：

• 查看与管理：Issue详情查看、列表筛选、浏览器打开
• 创建与编辑：支持自定义字段、多行描述、状态流转
• 协作功能：分配、评论、关注者通知管理
• 敏捷支持：Sprint查看、Backlog管理

双后端架构

| 后端 | 适用场景 | 优势 |

|------|---------|------|

| **CLI** (`ankitpokhrel/jira-cli`) | 本地环境、复杂JQL查询 | 功能完整、支持模板、离线友好 |

| **MCP** (Atlassian MCP) | 云端/容器环境 | 免安装、API原生、权限可控 |

显著优点

1. 智能降级：自动检测可用后端，CLI优先保证体验
2. 安全优先：所有修改操作需用户确认，强制显示变更前后对比
3. 防错设计：状态流转前自动获取当前状态，避免非法Transition
4. 批量友好：支持通过Issue Key模式（如PROJ-123）快速定位

潜在局限

• 认证依赖：需配置JIRA_API_TOKEN/USER/BASE_URL或MCP凭证
• 后端差异：部分功能CLI支持但MCP受限（如Issue链接需脚本 workaround）
• 学习成本：复杂字段创建需参考文档，非完全自然语言

适合人群

• 开发者：快速查看/更新自己负责的ticket
• Tech Lead：Sprint状态检查、批量Issue管理
• 项目经理：创建结构化ticket、跟踪工作流
• 运维/DevOps：集成到自动化流程（CLI模式）

常规风险

| 场景 | 风险 | 缓解措施 |

|------|------|---------|

| 状态流转 | 中间状态缺失导致失败 | 强制先fetch当前状态 |

| 批量修改 | 通知轰炸 | 需显式用户授权 |

| 描述编辑 | 无undo，数据丢失 | 展示原始内容对比 |

| MCP分配 | Display name不生效 | 强制使用account ID lookup |

使用建议

1. 优先安装jira CLI获得最佳体验：brew install ankitpokhrel/jira-cli/jira-cli && jira init
2. 复杂操作前加载reference文档（commands.md / mcp.md）
3. 生产环境操作务必开启approval确认

核心用法

Jira Skill 实现自然语言与 Jira 项目管理系统的双向交互，支持三大核心场景：事务查询（单条查看、列表筛选、JQL 搜索）、事务操作（创建、更新、状态流转、分配、评论）以及冲刺管理（活跃冲刺查看、待办列表）。

该 Skill 采用智能后端探测机制：优先使用本地 jira CLI（ankitpokhrel/jira-cli），次选 Atlassian MCP 工具集，无后端时引导用户完成配置。CLI 模式适合熟悉终端的用户，支持丰富的本地命令与浏览器快捷打开；MCP 模式则更贴近 IDE 工作流，通过标准化工具调用实现无缝集成。

显著优点

1. 多后端灵活适配：自动检测环境能力，CLI/MCP/REST 回退三层架构确保不同场景下的可用性
2. 严格的安全护栏：内置六条 NEVER 红线（禁止无确认流转、禁止显示名分配、禁止无展示编辑等），大幅降低误操作风险
3. 完善的权限透明：环境变量全为可选，明确标注使用场景，无强制凭证收集
4. 事务化工作流设计：创建/更新前强制获取当前状态、展示变更对比、征求显式批准

潜在局限

• 外部依赖强：必须预先安装 CLI 或配置 MCP，纯 REST 回退体验降级
• 过渡状态复杂：Jira 工作流因项目而异，"Done" 可能对应多种实际状态，需额外查询确认
• MCP 账户 ID 限制：分配任务时必须使用 account ID 而非显示名，增加一层转换步骤
• 无批量操作优化：明确禁止未经批准的批量修改，大规模数据处理效率受限

适合人群

敏捷开发团队、产品经理、Scrum Master 及需要频繁与 Jira 交互的技术人员。特别适合重视操作安全性、希望减少上下文切换的开发者。

常规风险

• 通知风暴：每次事务变更触发邮件/推送，批量操作需谨慎
• 不可逆编辑：Jira 描述字段无版本历史，覆盖即永久丢失
• 凭证泄露：若误将 JIRA_API_TOKEN 写入共享环境，可能导致项目数据暴露