SuperAPI AI 工具集

report-comment

编程与开发

查看项目

更新于 10-15 19:54

技能介绍

用途:把某个 Jira 工单相关的 git 提交,转写成一段简短的业务友好型实现报告,保存为本地 markdown 文件。读者(PM、QA、架构师)已打开工单,因此报告只写工单本身没有的信息:实际交付了什么、下游需要做什么不同的事。

主要能力:默认输出一段摘要;若工单修复已有问题则增加 Root Cause;仅当 diff 给出具体理由时才出现 Verify 和 Deploy 段落。

使用方式:先确定 issue key(用户提供,或从 git branch --show-current 中匹配 [A-Z]+-[0-9]+,否则询问),确认后预留输出文件:mkdir -p docs/jira-reports 与 touch "docs/jira-reports/$(date +%Y-%m-%d-%H%M%S)-<ISSUE_KEY>.md",同一会话内重复运行会更新同一文件。随后用 Atlassian MCP 的 getJiraIssue 获取工单(不可用时请用户粘贴标题、描述与验收标准),用 git log --grep="<ISSUE_KEY>" --format="%H %s" --reverse 收集提交,必要时用 --all 或与 main/master/develop 做 diff,并对整个提交范围取净结果 diff。

限制:不描述 diff 未体现的改动;删除例行工作与工单复述;文件保持未跟踪,不 stage 或 commit。若找不到工单、无提交、MCP 不可用或写入失败,需如实告知用户。具体收费、平台支持等信息暂未提供。