用途:通过 Python CLI 按 Jira REST API 完成搜索、查看、创建、更新问题,状态流转,添加或列出评论,以及发现问题类型和创建所需字段。
主要能力:search/get/create/update/transition/comment/comments/fields 命令;支持 --fields 点号记法精简输出,列表为制表符分隔。支持 Jira Cloud(邮箱加 API token)与 Jira Server/数据中心(PAT)两种认证,且按环境变量自动选择。
使用方式:需 Python 3.11+。设置 JIRA_BASE_URL,Cloud 另设 JIRA_USER_EMAIL、JIRA_API_TOKEN,Server 设 JIRA_PAT;可选 JIRA_CLOUD_TOKEN_MODE、JIRA_CLOUD_ID、JIRA_AUDIT_LOG、JIRA_DEBUG 等。CLI 会从 ~/.jira.env 读取变量,凭证值由用户自行编辑,不应粘贴到聊天。示例:python scripts/jira.py --fields key,fields.summary search 'assignee = currentUser() ORDER BY updated DESC'。
适用场景:批量查询进度、创建或更新问题、流转状态、补充评论、确认创建字段。
限制:不提供 OAuth 3LO 或 PAT 的签发;scoped 模式无法校验 Cloud ID 与基础 URL 的归属,需人工维护。写入需确认,审计日志为失败即中止;凭证文件在 POSIX 有权限与所有权校验。Jira 项目权限独立于 token scope。错误通过 401/403、连接错误等方式体现。其余未在资料中说明的细节暂未提供。