SuperAPI AI 工具集

jira-communication

办公与效率

查看项目

更新于 10-16 01:35

技能介绍

用途:在 Jira 上处理工单、冲刺、看板、链接、字段、工作日志、附件和用户等事务,也可在只提及 Jira 意图而未给出工单号时触发(如“create/find a ticket”)。

主要能力:脚本按功能分为三类。核心脚本包括 jira-issue.py、jira-search.py、jira-worklog.py、jira-attachment.py、jira-setup.py、jira-validate.py;工作流脚本包括 jira-create.py、jira-transition.py、jira-comment.py、jira-move.py、jira-sprint.py、jira-board.py、jira-version.py、tempo-account.py;工具脚本包括 jira-user.py、jira-fields.py、jira-link.py、jira-weblink.py、jira-worklog-query.py、jira-watchers.py、jira-qa-gather.py。识别到 Jira URL 或工单号(如 PROJ-123)时可按意图一键调用,例如 triage/work 用 jira-issue.py work KEY,QA 审核用 jira-issue.py qa KEY,QA 失败跟进用 jira-issue.py qa-fail KEY,仅查字段用 jira-issue.py get KEY --fields ...,改状态用 jira-issue.py act KEY 后接 jira-transition.py do,审计/同批发现用 jira-qa-gather.py KEY;认证问题交给 jira-setup.py。

使用方式:通过 uv run 直接执行,所有脚本支持 --help、--json、--quiet、--debug,全局参数需放在子命令之前,例如 jira-issue.py --json get PROJ-123。示例:update PROJ-123 --assignee me --priority Critical;jira-comment.py add PROJ-123 "Comment text";jira-transition.py do PROJ-123 "In Progress";jira-worklog.py add PROJ-123 2h --comment "Work done";jira-create.py issue PROJ "Summary" --type Task。状态流转先用 list 查看 id 及其页面要求,再把 id 传给 do;终态流转传 --resolution <value>,若被拒绝("cannot be set")则去掉重试。

写入校验:所有写 wiki 标记的 --comment 和 --description 默认经过三道关卡——转义会被渲染为删除线的连字符、检查块级标签与语言不匹配等 lint、以及由实例渲染后若被删除线化则拒写。--no-auto-escape 保留原文,但单独使用仍会被 lint 与渲染检查拦截,需配 --force;--force 使三类发现变为警告并照常发布;--no-preflight 跳过渲染检查;--dry-run 仍运行转义与 lint 并预览文本但不写入。经 --fields-json 写入的正文不受这三道关卡限制;jira-version.py 的两个 --description 字段也未被门控。

认证与配置:Cloud 使用 JIRA_URL + JIRA_USERNAME + JIRA_API_TOKEN;Server/DC 使用 JIRA_URL + JIRA_PERSONAL_TOKEN;配置可放 ~/.env.jira 或 ~/.jira/profiles.json,--profile 支持多配置。限制方面:具体效果、收费、平台支持等资料未提供;版本说明是否按 wiki 标记渲染未经核实。