名称: jira-集成 description: Jira问题跟踪和事件管理。在创建、搜索或更新Jira问题时使用。支持JQL查询用于事件票务分析和警报疲劳跟踪。 允许工具: Bash(python *)
Jira集成
认证
重要: 凭据由代理层自动注入。不要检查环境变量中的JIRA_API_TOKEN或JIRA_EMAIL - 您将看不到它们。直接运行脚本；认证透明处理。
您可以检查的配置环境变量（非机密）：
JIRA_URL- Jira实例URL（例如，https://your-company.atlassian.net）
可用脚本
所有脚本位于.claude/skills/project-jira/scripts/
search_issues.py - 使用JQL搜索
使用Jira查询语言进行强大搜索。最适合查找事件票务、模式、行动项。
python .claude/skills/project-jira/scripts/search_issues.py --jql "JQL_QUERY" [--max-results N]
# 示例:
python .claude/skills/project-jira/scripts/search_issues.py --jql "type = Bug AND status != Done AND created >= -7d"
python .claude/skills/project-jira/scripts/search_issues.py --jql "labels = incident AND created >= -30d" --max-results 50
get_issue.py - 获取问题详情
python .claude/skills/project-jira/scripts/get_issue.py --issue-key PROJ-123
create_issue.py - 创建新问题
python .claude/skills/project-jira/scripts/create_issue.py --project PROJ --summary "标题" --description "详情" [--type Bug] [--priority High] [--labels "incident,p1"]
update_issue.py - 更新现有问题
python .claude/skills/project-jira/scripts/update_issue.py --issue-key PROJ-123 [--summary "新标题"] [--status "进行中"] [--priority High]
add_comment.py - 添加评论
python .claude/skills/project-jira/scripts/add_comment.py --issue-key PROJ-123 --comment "调查发现..."
list_issues.py - 列出项目问题
python .claude/skills/project-jira/scripts/list_issues.py --project PROJ [--max-results 20]
JQL快速参考
常见模式
# 最近错误
type = Bug AND created >= -7d ORDER BY created DESC
# 开放事件
type = Incident AND status != Done
# 按标签
labels IN ("incident", "p1", "alert-tuning")
# 文本搜索
summary ~ "高CPU" OR description ~ "超时"
# 陈旧问题
updated <= -90d AND status != Done
运算符
| 运算符 | 含义 | 示例 |
|---|---|---|
| = | 等于 | status = Done |
| != | 不等于 | status != Done |
| ~ | 包含文本 | summary ~ "错误" |
| IN | 在列表中 | status IN ("Open", "In Progress") |
| >= | 大于/等于 | created >= -7d |
| ORDER BY | 排序 | ORDER BY created DESC |
调查工作流
事件票务分析
1. 搜索相关事件：
search_issues.py --jql "type = Incident AND created >= -30d"
2. 获取特定事件详情：
get_issue.py --issue-key INC-456
3. 添加调查发现：
add_comment.py --issue-key INC-456 --comment "根因：..."
4. 更新状态：
update_issue.py --issue-key INC-456 --status "已解决"