Jira 技能

通过 Clawdbot 处理 Jira 问题和工时记录（搜索、状态查看、创建、记录工时、工时记录摘要）。

设置

1. 获取您的 API 密钥：https://id.atlassian.com/manage-profile/security/api-tokens
2. 点击 "创建 API 令牌"
3. 设置环境变量：

   export JIRA_EMAIL="you@example.com"
   export JIRA_API_TOKEN="your-api-token"
   export JIRA_URL="https://your-domain.atlassian.net"
   # Optional project scope (comma-separated). Empty = search all.
   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 issue ABC-123— 快速问题详情
• {baseDir}/scripts/jira.sh status ABC-123 "进行中"— 移动一个问题（验证可用转换）
• {baseDir}/scripts/jira.sh transitions ABC-123— 列出允许的转换
• {baseDir}/scripts/jira.sh assign ABC-123 "姓名或邮箱"— 通过用户搜索分配
• {baseDir}/scripts/jira.sh assign-me ABC-123— 分配给自己
• {baseDir}/scripts/jira.sh comment ABC-123 "文本"— 添加评论
• {baseDir}/scripts/jira.sh create "标题" ["描述"]— 在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 [姓名|邮箱]— 某日的工时记录，按用户/问题分组；可选筛选器（姓名/邮箱；也可解析为账户ID）
• {baseDir}/scripts/jira.sh hours-issue ABC-123 [姓名|邮箱]— 某个问题的工时记录；可选筛选器（姓名/邮箱；也可解析为账户ID）

命令参考

• 搜索问题

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

• 问题链接

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

• 问题详情

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

• 更新状态

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

• 列出状态转换

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

• 分配问题

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

• 分配给自己

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

• 添加评论

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

• 创建问题

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

• 记录工时

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

• 我未解决的问题

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

• 按问题统计的已记录工时（我的）

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

• 某日的工时记录（所有人）

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

• 某日的工时记录（用户筛选）

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

• 记录问题的工作时间

  {baseDir}/scripts/jira.sh hours-issue ABC-321 "jane"
  

备注

• 工作日志命令使用Jira的worklog/updated + worklog/list组合，在大型项目上可能需要几秒钟。
• 小时筛选依据JIRA_EMAIL;每日工时返回所有用户及其在每个问题上的总工时。
• 工时命令的输出为JSON格式，以便在其他工具中重复使用。
• 状态转换在应用前会对照服务器提供的转换列表进行验证。