Jira Issue Analyzer
前置检查
- 1. Jira 脚本目录(已迁移到 Skill 内,不在项目目录):
-
~/.cursor/skills/jira-issue-analyzer/jira
- 2. 初始化虚拟环境(必须):
-
cd ~/.cursor/skills/jira-issue-analyzer/jira
-
python3 -m venv .venv
-
.venv/bin/python -m pip install -r requirements.txt
- 3. 配置:
-
cp .env.example .env
- 填写
JIRA_BASE_URL、
JIRA_TOKEN
- 4. 连接测试(必须使用 venv python):
- INLINECODE7
标准工作流
1) 获取 issue 信息
CODEBLOCK0
2) 下载附件
CODEBLOCK1
3) 解压压缩包并递归处理
需要时解压压缩包,作为后续分析输入。
4) 委托日志分析 subagent
日志分析与问题归因请直接委托个人 subagent:
- -
jira-log-analyst(定义文件:~/.cursor/agents/jira-log-analyst.md)
5) 输出标准报告
按 report-template.md 结构输出。
6) 报告落地到本地文件
将报告以 Markdown 文件保存到项目目录:
- - 目录: INLINECODE10
- 文件名建议: INLINECODE11
示例路径:
7) 清理下载附件
报告生成并保存后,删除临时附件目录,避免磁盘堆积:
- - 例如删除 INLINECODE13
- 必须在报告落盘完成后再执行
快速命令参考
CODEBLOCK2
Jira Issue 分析器
前置检查
- 1. Jira 脚本目录(已迁移至 Skill 内,不在项目目录):
- ~/.cursor/skills/jira-issue-analyzer/jira
- 2. 初始化虚拟环境(必须):
- cd ~/.cursor/skills/jira-issue-analyzer/jira
- python3 -m venv .venv
- .venv/bin/python -m pip install -r requirements.txt
- 3. 配置:
- cp .env.example .env
- 填写 JIRA
BASEURL、JIRA_TOKEN
- 4. 连接测试(必须使用 venv python):
- .venv/bin/python main.py --test
标准工作流
1) 获取 issue 信息
bash
cd ~/.cursor/skills/jira-issue-analyzer/jira
.venv/bin/python main.py get KEYOR_URL> -f json
2) 下载附件
bash
cd ~/.cursor/skills/jira-issue-analyzer/jira
.venv/bin/python main.py download KEYORURL> -d /tmp/jira
3) 解压压缩包并递归处理
需要时解压压缩包,作为后续分析输入。
4) 委托日志分析子代理
日志分析与问题归因请直接委托个人子代理:
- - jira-log-analyst(定义文件:~/.cursor/agents/jira-log-analyst.md)
5) 输出标准报告
按 report-template.md 结构输出。
6) 报告落地到本地文件
将报告以 Markdown 文件保存到项目目录:
- - 目录:/.cursor/work/jira/
- 文件名建议:KEY>analysis.md
示例路径:
- - /Users/zhangyu/FlutterProject/flutterhiiggeapp/.cursor/work/jira/PI2506-150_analysis.md
7) 清理下载附件
报告生成并保存后,删除临时附件目录,避免磁盘堆积:
- - 例如删除 /tmp/jiraKEY>
- 必须在报告落盘完成后再执行
快速命令参考
bash
获取 issue 详情
cd ~/.cursor/skills/jira-issue-analyzer/jira
.venv/bin/python main.py get HA-2560 -f json
下载附件
.venv/bin/python main.py download HA-2560 -d /tmp/jira_HA-2560