🧭 Jira — 项目管理与跟踪

技能文档

工作与 Jira 问题和工作日志（搜索、状态、创建、记录工作时间等）

设置

• 获取 API 密钥：https://id.atlassian.com/manage-profile/security/api-tokens
• 点击“创建 API 令牌”
• 设置环境变量：

export JIRA_EMAIL="you@example.com"
export JIRA_API_TOKEN="your-api-token"
export JIRA_URL="https://your-domain.atlassian.net"
# 可选项目范围（逗号分隔）。空 = 搜索所有。
export JIRA_BOARD="ABC"

快速命令

• {baseDir}/scripts/jira.sh search "timeout" [max] — 模糊搜索摘要或键（在 JIRA_BOARD 内）
• {baseDir}/scripts/jira.sh link ABC-123 — 浏览器链接 для 问题
• {baseDir}/scripts/jira.sh issue ABC-123 — 快速问题详细信息
• {baseDir}/scripts/jira.sh status ABC-123 "In Progress" — 移动问题（验证可用状态转换）
• {baseDir}/scripts/jira.sh transitions ABC-123 — 列出允许的状态转换
• {baseDir}/scripts/jira.sh assign ABC-123 "name or email" — 根据用户搜索分配
• {baseDir}/scripts/jira.sh assign-me ABC-123 — 分配给自己
• {baseDir}/scripts/jira.sh comment ABC-123 "text" — 添加评论
• {baseDir}/scripts/jira.sh create "Title" ["Description"] — 在 JIRA_BOARD 中创建任务
• {baseDir}/scripts/jira.sh log ABC-123 2.5 [YYYY-MM-DD] — 记录小时（默认为今天 UTC）
• {baseDir}/scripts/jira.sh my [max] — 为您打开的问题
• {baseDir}/scripts/jira.sh hours 2025-01-01 2025-01-07 — 按问题记录的小时（JSON）
• {baseDir}/scripts/jira.sh hours-day 2025-01-07 [name|email] — 一天内记录的小时，按用户/问题分组；可选筛选（名称/电子邮件；也可解析为 accountId）
• {baseDir}/scripts/jira.sh hours-issue ABC-123 [name|email] — 问题的记录小时；可选筛选（名称/电子邮件；也可解析为 accountId）

命令参考