核心用法
Jira Skill 是 Maton 平台提供的 Jira Cloud API 代理服务，采用托管式 OAuth 认证架构。用户无需自行处理 Atlassian OAuth 的复杂流程，只需获取 Maton API Key 并完成一次授权，即可通过统一的 REST 接口操作 Jira 实例。
典型工作流：
1. 获取 Cloud ID → 调用 /jira/oauth/token/accessible-resources 获取用户可访问的 Jira 站点
2. 建立连接 → 在 Maton 平台创建 Jira 连接并完成 OAuth 授权
3. 执行操作 → 通过 api.maton.ai/jira/ex/jira/{cloudId}/rest/api/3/... 代理路径调用原生 Jira API
核心功能覆盖：
- Issue 管理：JQL 搜索、创建、更新、删除、分配、状态流转
- 项目管理：项目列表、详情查询
- 评论交互：获取与添加评论（支持 Atlassian Document Format）
- 用户与元数据：当前用户信息、用户搜索、Issue 类型、优先级、状态枚举
---
显著优点
| 维度 | 说明 |
|------|------|
| **认证简化** | 托管 OAuth 免去自行申请 Atlassian 应用、处理 token 刷新等繁琐流程 |
| **协议兼容** | 代理层保留原生 Jira REST API 路径与响应格式，现有 Jira 文档和 SDK 可直接参考 |
| **多连接支持** | 通过 `Maton-Connection` 头部可指定多个 Jira 账户，适合 MSP 或多租户场景 |
| **多语言示例** | 提供 Python、JavaScript、Bash/curl 完整可运行代码片段 |
---
潜在局限与风险
架构依赖：
- 完全依赖 Maton 代理服务的可用性，若
api.maton.ai出现故障或停止服务，集成将中断 - Agile API（看板、Sprint）需要额外 OAuth 权限，默认未开启，需联系支持开通
安全约束：
- 文档明确要求"所有写操作需显式用户确认"，但实际执行层面依赖调用方（LLM/Agent）的自我约束，无强制技术拦截
- API Key 一旦泄露，攻击者可遍历用户所有连接的 Jira 数据，缺乏细粒度权限隔离（如按项目限定）
运维细节：
- curl 使用注意事项（
-g禁用 glob、管道导致环境变量解析失败）表明工具链成熟度有待提升 - 速率限制 10 req/sec 对批量操作场景可能构成瓶颈
---
适合人群
- 开发团队：需要将 Jira 集成到内部工具、CLI 或自动化脚本中
- AI Agent 构建者：为 LLM 提供标准化 Jira 工具调用能力
- 多账户管理员：需要统一管理多个 Jira 站点的技术团队
---
常规风险提示
1. 密钥管理：MATON_API_KEY 具备账户级权限，应使用密钥管理服务，避免硬编码
2. 数据边界：代理服务可能记录请求元数据，敏感项目需评估合规性
3. OAuth 授权范围：首次授权时仔细审查 Maton 请求的权限列表，避免过度授权
4. JQL 注入：构造动态 JQL 时需对输入进行转义，防止查询注入导致的非预期数据泄露