SuperAPI AI 工具集

jira-impl-logger

编程与开发

查看项目

更新于 10-16 02:39

技能介绍

用途:任务完成后,将某个任务的实现内容以结构化评论写入对应 JIRA 工单,使其可通过 JIRA 查询检索,作为“已存在什么”的规范知识库,供后续工程师和 AI 智能体在写新代码前先检索。由执行器(task-executor / sprint-executor)在每完成一个任务时调用,也可直接调用以补录日志。

主要能力:接收工单键、摘要、新建文件、修改文件、统计(来自 git diff --shortstat 的 linesAdded / linesRemoved)、产物、提交哈希,以及可选的 docs 后端(confluence 或 notion)。产物字段为结构化数据,改编自 spec-workflow-mcp,包含 apiEndpoints、components、functions、classes、integrations、dataModels、pipelineStages,均为可选。

使用方式:先校验输入——确认工单存在、至少提供一个产物类别、文件列表非空,输入不足时向调用方补充;再依据模板渲染评论(含摘要、提交、日期、文件、产物表格、可检索关键词);用 mcp__Atlassian__addCommentToJiraIssue 发布;用 editJiraIssue 给工单添加 impl-logged 标签;若配置了 docs 后端,再通过 docs 适配器 publishRecord 镜像到 Notion 的 Impl Logs 数据库行或 Confluence 页面;最后返回评论 URL、标签确认与镜像 URL(如有)。

适用场景:需要保留“已实现内容”可检索记录、并希望后续 AI 智能体通过 Atlassian MCP 的 searchJiraIssuesUsingJql 先检索再写代码的团队;补录:对从未记录日志的已关闭工单,可读取描述与提交,用 git log --follow、git show 识别文件与统计,并从 diff 推断产物,草稿先交给用户确认再发布。

限制:不评估代码质量,不关闭 JIRA 工单,不把日志写入仓库,不添加提交或运行测试;产物类别为空属于失败模式,纯重构可留空但必须在摘要中说明。若 Impl Logs 数据集不存在,不应静默跳过而应提示调用方创建。截至资料未提供具体权限、收费与部署要求。