with one click
jira-analyze
// 对 Jira Issue 进行深度根因分析并给出修复建议。当用户要求分析某个 Jira issue 时使用此 skill,支持自动下载 Jira 附件、分析日志、定位可疑代码、输出根因诊断与修复建议。采用结构化沉淀和 case-based reasoning 实现可持续学习。
// 对 Jira Issue 进行深度根因分析并给出修复建议。当用户要求分析某个 Jira issue 时使用此 skill,支持自动下载 Jira 附件、分析日志、定位可疑代码、输出根因诊断与修复建议。采用结构化沉淀和 case-based reasoning 实现可持续学习。
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | jira-analyze |
| description | 对 Jira Issue 进行深度根因分析并给出修复建议。当用户要求分析某个 Jira issue 时使用此 skill,支持自动下载 Jira 附件、分析日志、定位可疑代码、输出根因诊断与修复建议。采用结构化沉淀和 case-based reasoning 实现可持续学习。 |
当用户要求以下操作时使用此 skill:
□ 调用 enter_analyze(issue_key) 获取 Jira 信息
□ 根据jira的基本信息,从confluence查询相关文档和分析经验
□ 分析日志(grep_files 过滤关键词,参考文档中的关键词)
□ 根据jira和log的信息,从opengrok查找相关的代码
□ 从history中查看有没有相似的历史jira issue,如果有,使用jira工具探索一下
□ 按 `artifacts` skill 的规范读取/复用已有 artifact,并沉淀新的分析产物
□ 整理最终结论(结论、根因、证据、修复建议、历史案例参考)
□ 调用 exit_analyze(issue_key, conclusion) 完成分析
1. 必须按照todo来执行分析过程
2. 所有产物必须通过 artifact tools 或 exit_analyze 写入,artifact 的读取、复用、命名、写入和删除规则统一参考 `.aiyo/skills/artifacts/SKILL.md`。
3. exit_analyze 是唯一结束分析的方式
4. 最终传给 exit_analyze 的必须是简短结论段落,不是 JSON 草稿,也不是长篇调试转录
先调用 enter_analyze(issue_key),拿到分析工作区和上下文。
重点阅读以下字段:
summary: Jira 基本信息摘要,包含标题、状态、优先级、组件、标签description: Jira 描述正文comments: 评论区内容,常有补充现象、复现步骤、临时结论attachments: 附件下载结果history_path: 本地 history 缓存文件路径,内容来自 jira-historyartifact_titles: 当前 artifact store 中已有的页面标题列表,但不包含 jira-history执行要求:
artifacts skillartifacts skill 的约定沉淀信息缺口必须在分析日志之前完成!
在 "MMAD+-+Docs" 页面(ID: 665519915)下:
执行要求:
components、标题关键词、日志中的模块名匹配页面按 artifacts skill 的规范,把相关 Confluence 页面和用途说明写入合适的 artifact title / section。
优先分析 attachments 中 type=log 且 status=downloaded 的文件。带着文档关键词去筛日志,不要盲读全部附件。
先做两轮检索:
error / fail / timeout / panic / exception / warning建议方式:
grep_files(pattern="文档关键词|通用错误词", ...)
根据 Jira 信息、Confluence 关键词、日志中的函数名/模块名/错误码,调用 OpenGrok 查相关代码。
优先查这些内容:
执行要求:
必须对本地 history_path 做 grep/read,判断有没有相似的历史 Jira issue。
执行要求:
history_path 做检索history.txt;必须继续使用 Jira 工具做二次探索按 artifacts skill 的规范,读取/复用已有 artifact,并沉淀新的分析产物。
至少覆盖这些内容:
在调用 exit_analyze 前,先整理一份简短 conclusion 段落。建议压缩到几句话,至少覆盖:
要求:
exit_analyze;详细内容应该已经沉淀在 artifacts 里调用:
exit_analyze(issue_key, conclusion)
系统会:
conclusion 里自动生成一行摘要和 3 个 tagsjira-history artifact page注意:
analysis_structexit_analyze 成功后,本次分析才算真正完成.jira-analysis/
└── PROJ-123/
├── history.txt # 从 jira-history 下载的本地 history 缓存
└── attachments/ # 仅当前分析周期的临时附件
持久化位置:
jira-historyjira、confluence、gerrit 是常用建议;分析文章的 section 可以自由发挥,但命名要可读、可复用。title + section 要覆盖更新。conclusion 并通过它完成 history 沉淀和清理。