mcpField
J
jira-ticket-viewer

jira-ticket-viewer

github.com/delexw生产力255 次安装31 周前更新
代码仓库

关于 jira-ticket-viewer

jira-ticket-viewer 是用于获取并展示 Jira 工单详情的技能，面向使用 jira CLI 处理工单的人。它会解析工单数据、整理评论，并在有附件时下载文件。

主要功能

  1. 01使用 jira CLI 获取工单原始数据
  2. 02解析工单并生成 JSON 档案
  3. 03获取并添加关联拉取请求
  4. 04将评论整理为摘要
  5. 05下载附件并返回文件路径

适用场景

  1. 01查看 Jira 工单并生成结构化档案
  2. 02汇总工单评论以便审阅
  3. 03获取工单关联的拉取请求和附件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/delexw/claude-code-misc --skill jira-ticket-viewer

安装后在 Claude Code 中输入/jira-ticket-viewer确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
comment-rules.md
output-format.md
rules.md
scripts/
download-attachment.js
fetch-pull-requests.js
parse-ticket.js

详细介绍

Jira 工单查看器

使用 jira CLI 工具获取并显示 Jira 工单详情。

输入

原始参数：$ARGUMENTS

根据参数推断：

  • TICKET_KEY：Jira 问题键
  • OUT_DIR：输出目录；如果未提供，则使用 .implement-assets/jira

系统要求

  • 已安装并配置 jira CLI（https://github.com/ankitpokhrel/jira-cli）
  • 设置环境变量 JIRA_API_TOKEN，其值为有效的 Jira API 令牌。重要提示： 检查此变量时，至少验证 2 次，然后再确认其未设置。由于 Shell 上下文差异，环境变量可能会显示为未设置。切勿泄露其值——只能检查变量是否存在（例如：test -n "$JIRA_API_TOKEN"）。
  • 设置环境变量 JIRA_SERVER，其值为 Jira 基础 URL（例如：https://yourcompany.atlassian.net）。

执行

  1. 执行前检查：运行 jira me，确认 CLI 已安装且已通过身份验证；如果失败，请遵循 references/rules.md 中的错误处理说明。jira me 成功前，不要继续。
  2. 根据 references/rules.md 验证 TICKET_KEY
  3. 获取原始 JSON（单次 API 调用）：通过 Bash 运行 mkdir -p OUT_DIR && jira issue view TICKET_KEY --raw > OUT_DIR/raw.json
  4. 解析工单：通过 Bash 运行 node ${CLAUDE_SKILL_DIR}/scripts/parse-ticket.js < OUT_DIR/raw.json > OUT_DIR/dossier.json，获取解析后的 JSON 输出
  5. 获取拉取请求：通过 Bash 运行 node ${CLAUDE_SKILL_DIR}/scripts/fetch-pull-requests.js < OUT_DIR/raw.json > OUT_DIR/pull-requests.json。如果输出是非空数组，则读取 OUT_DIR/dossier.json，添加包含该数组的 pullRequests 字段，并使用 Write 工具保存。获取 PR 失败不会导致流程终止——发出警告并继续。
  6. 解读评论：如果解析后的 JSON 包含非空的 comments 数组，请按照 references/comment-rules.md 分析这些评论。将 JSON 中的 comments 数组替换为 commentSummary 对象，然后使用 Write 工具将更新后的 JSON 保存回 OUT_DIR/dossier.json。
  7. 附件：如果解析后的 JSON 包含非空的 attachments 数组，请下载这些附件：
    • 通过 Bash 运行 node ${CLAUDE_SKILL_DIR}/scripts/download-attachment.js --out OUT_DIR < OUT_DIR/raw.json
    • 在输出中包含已下载附件的文件路径
  8. 返回解析后的 JSON 输出（架构参考见 references/output-format.md），如果有附件下载路径，也一并包含

评论

支持 Markdown