SuperAPI AI 工具集

twg-jira

通用与其它

查看项目

更新于 10-15 17:20

技能介绍

用途:当 Jira 是事实来源或需要变更 Jira 数据时,配合根 twg 技能使用。适用于已知 Jira key、issue URL、项目 key、面板、冲刺、过滤器或仪表盘作为主要锚点的场景,以及创建、更新、流转、评论、链接、关注或删除 Jira 工作的需求。

主要能力:支持工作项读取(单条 get 或一次性 bulk-get 多个 key)、JQL 查询与过滤、基于 JQL 的工作项搜索、语义检索(rovo search --app jira)、重复工作项检测,以及字段与流转元数据发现。可通过 typed artifact links 为工作项添加指向 PR、仓库、部署、构建、分支、提交、Loom 视频或会议的 Jira 远程链接。还涉及 Jira 配置与工作项字段值的管理。

使用方式:先运行 twg <command>,若提示命令未找到,macOS/Linux 使用 $HOME/.local/bin/twg,PowerShell 使用 $env:LOCALAPPDATA\Programs\twg\bin\twg.exe,并告知用户将该目录加入 PATH。变更前应先读取当前状态,发现创建/更新字段元数据,使用返回的 customfield_* ID 而非显示名。发现流转时可用 twg jira workitem transition --id <KEY> --site <SITE> -o json(不带 --transition-id)查看可用流转及所需屏幕字段,再据其要求收集字段值后带 --transition-id 调用。执行不熟悉或有后果的变更前,先运行 twg help describe "<exact path>"。

限制:必填字段属于用户决策输入,用户未提供时不得自行推断或选择允许值,应询问用户,Resolution 亦然(取消请求不等于 Won't Do、Declined 或 Duplicate)。Jira 项目/空间不同于 Atlas 项目;JSM 请求虽对应底层 Jira 工作项,但审批、门户、队列、请求类型和 SLA 属于 JSM。搜索结果只是候选锚点,最终字段与状态应以本地工作项读取为准。不要仅因 Jira 作为交叉产品回答中的支撑产物就加载本技能。