Jira Metrics — Jira 指标

Work with Jira issues and work记录s from Clawd机器人 (搜索, 状态, 创建, 记录 work, work记录 summaries).

设置up

• 获取 your API key: https://id.atlassian.com/manage-性能分析/security/API-令牌s
• 命令行工具ck "创建 API 令牌"
• 设置 环境 variables:

```bash 导出 JIRA_EMAIL="you@example.com" 导出 JIRA_API_令牌="your-API-令牌" 导出 JIRA_URL="https://your-domAIn.atlassian.net" # Optional project scope (comma-separated). Empty = 搜索 all. 导出 JIRA_BOARD="ABC"

Requires curl, jq, bc, and python3.

Quick Commands

All commands live in {baseDir}/scripts/jira.sh.

{baseDir}/scripts/jira.sh 搜索 "timeout" [max] — fuzzy 搜索 by summary or key inside JIRA_BOARD {baseDir}/scripts/jira.sh link ABC-123 — browser link for an issue {baseDir}/scripts/jira.sh issue ABC-123 — quick issue detAIls {baseDir}/scripts/jira.sh 状态 ABC-123 "In 进度" — move an issue (验证s avAIlable transitions) {baseDir}/scripts/jira.sh transitions ABC-123 — 列出 allowed transitions {baseDir}/scripts/jira.sh as签名 ABC-123 "name or emAIl" — as签名 by user 搜索 {baseDir}/scripts/jira.sh as签名-me ABC-123 — as签名 to yourself {baseDir}/scripts/jira.sh comment ABC-123 "text" — 添加 a comment {baseDir}/scripts/jira.sh 创建 "Title" ["Description"] — 创建 a Task in JIRA_BOARD {baseDir}/scripts/jira.sh 记录 ABC-123 2.5 [YYYY-MM-DD] — 记录 hours (defaults to today UTC) {baseDir}/scripts/jira.sh my [max] — open issues as签名ed to you {baseDir}/scripts/jira.sh hours 2025-01-01 2025-01-07 — your 记录ged hours by issue (JSON) {baseDir}/scripts/jira.sh hours-day 2025-01-07 [name|emAIl] — 记录ged hours for a day grouped by user/issue; optional 过滤器 (name/emAIl; also resolves to accountId) {baseDir}/scripts/jira.sh hours-issue ABC-123 [name|emAIl] — 记录ged hours for an issue; optional 过滤器 (name/emAIl; also resolves to accountId) Command Reference

搜索 issues

{baseDir}/scripts/jira.sh 搜索 "payment 失败" [max结果s]

Issue link

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

Issue detAIls

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

更新 状态

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

列出 transitions

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

As签名 issue

{baseDir}/scripts/jira.sh as签名 ABC-321 "Jane Doe"

As签名 to yourself

{baseDir}/scripts/jira.sh as签名-me ABC-321

添加 comment

{baseDir}/scripts/jira.sh comment ABC-321 "部署ed to staging"

创建 issue

{baseDir}/scripts/jira.sh 创建 "Fix auth timeout" "Users being 记录ged out after 5m"

记录 hours

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

My open issues

{baseDir}/scripts/jira.sh my [max结果s]

记录ged hours by issue (me)

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

记录ged hours for a day (everyone)

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

记录ged hours for a day (user 过滤器)

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

记录ged hours for an issue

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

Notes Work记录 commands use Jira's work记录/更新d + work记录/列出 combo and may take a few seconds on large projects. hours 过滤器s by JIRA_EMAIL; hours-day returns all users with totals per issue and user. 输出s for hours commands are JSON for reuse in other 工具s. 状态 transitions are 验证d agAInst the server‑provided transition 列出 before 应用lying.