名称： jira
描述： 通过 Jira Cloud REST API 管理 Jira 问题、状态转换和工作日志。
主页： https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
元数据：
{
"clawdbot":
{
"emoji": "🧭",
"requires":
{
"bins": ["curl", "jq", "bc", "python3"],
"env": ["JIRA_URL", "JIRA_EMAIL", "JIRA_API_TOKEN"],
"optional_env": ["JIRA_BOARD"],
},
},
}

Jira 技能

通过 Clawdbot 处理 Jira 问题和工作日志（搜索、查看状态、创建、记录工时、汇总工作日志）。

设置

1. 获取 API 密钥：https://id.atlassian.com/manage-profile/security/api-tokens
2. 点击 "Create API Token"
3. 设置环境变量：
   bash 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"

需要 curl、jq、bc 和 python3。

快速命令

所有命令位于 {baseDir}/scripts/jira.sh。

• {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）

命令参考

• 搜索问题

bash {baseDir}/scripts/jira.sh search "payment failure" [maxResults]

• 问题链接

bash {baseDir}/scripts/jira.sh link ABC-321

• 问题详情

bash {baseDir}/scripts/jira.sh issue ABC-321

• 更新状态

bash {baseDir}/scripts/jira.sh status ABC-321 "Done"

• 列出状态转换

bash {baseDir}/scripts/jira.sh transitions ABC-321

• 分配问题

bash {baseDir}/scripts/jira.sh assign ABC-321 "Jane Doe"

• 分配给自己

bash {baseDir}/scripts/jira.sh assign-me ABC-321

• 添加评论

bash {baseDir}/scripts/jira.sh comment ABC-321 "Deployed to staging"

• 创建问题

bash {baseDir}/scripts/jira.sh create "Fix auth timeout" "Users being logged out after 5m"

• 记录工时

bash {baseDir}/scripts/jira.sh log PB-321 1.5 2025-01-18

• 我的未解决问题

bash {baseDir}/scripts/jira.sh my [maxResults]

• 按问题查看我的记录工时

bash {baseDir}/scripts/jira.sh hours 2025-01-01 2025-01-05

• 查看某日所有人的记录工时

bash {baseDir}/scripts/jira.sh hours-day 2025-01-05

• 查看某日特定用户的记录工时

bash {baseDir}/scripts/jira.sh hours-day 2025-01-05 "jane"

• 查看特定问题的记录工时
  bash {baseDir}/scripts/jira.sh hours-issue ABC-321 "jane"

注意事项

• 工作日志命令使用 Jira 的 worklog/updated + worklog/list 组合，在大型项目中可能需要几秒钟。
• hours 命令按 JIRA_EMAIL 筛选；hours-day 返回所有用户，并按问题和用户汇总总工时。
• 工时命令的输出为 JSON 格式，便于在其他工具中复用。
• 在应用状态转换前，会先根据服务器提供的转换列表进行验证。