SuperAPI AI 工具集

jira-ticket-viewer

通用与其它

查看项目

更新于 10-16 08:35

技能介绍

用途:在 Claude Code 环境中,根据给定的 Jira 工单 Key,调用 jira-cli 获取并整理工单详情,便于后续分析或实现。

主要能力:从参数推断 TICKET_KEY 与输出目录 OUT_DIR(未提供时默认 .implement-assets/jira);执行预检(jira me)确认 CLI 已安装并完成认证;校验 TICKET_KEY(规则见 references/rules.md);通过一次 API 调用获取原始 JSON;用 scripts/parse-ticket.js 解析工单为 dossier.json;用 scripts/fetch-pull-requests.js 获取关联拉取请求并写回 dossier.json;若存在评论则按 references/comment-rules.md 归纳为 commentSummary;若存在附件则用 scripts/download-attachment.js 下载并记录路径。最终返回解析后的 JSON 输出(格式见 references/output-format.md)。

必要用法:需已安装并配置 jira CLI(https://github.com/ankitpokhrel/jira-cli),设置 JIRA_API_TOKEN 与 JIRA_SERVER;检查 JIRA_API_TOKEN 时建议至少验证两次,只用存在性检查(如 test -n "$JIRA_API_TOKEN"),不要暴露其值;预检失败需按错误处理规则停止,直至 jira me 成功。

适用场景:需要快速查看或批量整理 Jira 工单细节、关联代码变更与讨论内容的开发与协作流程。

限制:依赖外部 jira-cli 与有效 Jira 凭证;拉取请求获取失败属非致命,仅告警后继续;具体错误处理、校验与输出格式规则参见对应 references 文件,其余细节暂未提供。