SuperAPI AI 工具集

jira-report-comment

办公与效率

查看项目

更新于 10-15 19:54

技能介绍

用途:根据某个 Jira 工单的 git 提交,生成一段简短的、面向业务的实现报告(默认一段总结),保存为本地 Markdown 文件,供已打开工单的 PM、QA 或架构师阅读,只写工单本身无法体现的内容:实际交付了什么、下游需要做什么不同的事。

主要能力:默认输出一段总结;若工单修复的是已存在问题则增加 Root Cause 段落;当 diff 给出具体依据时,才出现 Verify 与 Deploy 段落。支持从用户提供的键、当前分支名中匹配 [A-Z]+-[0-9]+,或询问用户来确定 issue key。可通过 Atlassian MCP 的 getJiraIssue 获取工单,MCP 不可用时由用户手动粘贴标题、描述与验收标准。

使用方式:先确定 issue key 并确认,预留输出文件路径并全程写入同一路径(同一 issue 重复运行会更新而非新建):

mkdir -p docs/jira-reports touch "docs/jira-reports/$(date +%Y-%m-%d-%H%M%S)-<ISSUE_KEY>.md"

随后用 git log --grep="<ISSUE_KEY>" --format="%H %s" --reverse 收集提交,找不到时用 --all 重试,或用 git diff $(git merge-base HEAD main)..HEAD --stat 等方式与 base 分支对比;有多个提交时对整体范围取净 diff。

限制:找不到提交、无有意义 diff、issue key 无效、MCP 不可用或写入失败时需按情况报告或询问;文件保持未跟踪,不要 stage 或 commit;不描述 diff 中未体现的改动。