Jira Metric — 技能工具
v1.0.0[自动翻译] Retrieve and analyze Jira worklog metrics by user, issue, or date ranges through Jira Cloud REST API calls.
详细分析 ▾
运行时依赖
版本
Initial release of the Jira skill. - Manage Jira issues, transitions, and worklogs via the Jira Cloud REST API. - Includes commands for searching, status changes, assignment, comments, creation, and logging work. - Provides worklog summaries and JSON-export for tracked hours. - Supports filtering by project, user, day, and issue. - Requires `curl`, `jq`, `bc`, and `python3`; environment variables for Jira Cloud credentials.
安装命令
点击复制本土化适配说明
Jira Metric — 技能工具 安装说明: 安装命令:npx clawhub@latest install jirametric
技能文档
---
name: jira
description: Manage Jira issues, transitions, and worklogs via the Jira Cloud REST API.
homepage: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
metadata:
{
"clawdbot":
{
"emoji": "🧭",
"requires":
{
"bins": ["curl", "jq", "bc", "python3"],
"env": ["JIRA_URL", "JIRA_EMAIL", "JIRA_API_TOKEN"],
"optional_env": ["JIRA_BOARD"]
},
},
}
# Jira Skill
Work with Jira issues and worklogs from Clawdbot (search, status, create, log work, worklog summaries).
Setup
- Get your API key: https://id.atlassian.com/manage-profile/security/api-tokens
- Click "Create API Token"
- Set environment variables:
bash
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"
bash {baseDir}/scripts/jira.sh search "payment failure" [maxResults]Requirescurl,jq,bc, andpython3.Quick Commands
All commands live in
{baseDir}/scripts/jira.sh.
{baseDir}/scripts/jira.sh search "timeout" [max]— fuzzy search by summary or key insideJIRA_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 status ABC-123 "In Progress"— move an issue (validates available transitions){baseDir}/scripts/jira.sh transitions ABC-123— list allowed transitions{baseDir}/scripts/jira.sh assign ABC-123 "name or email"— assign by user search{baseDir}/scripts/jira.sh assign-me ABC-123— assign to yourself{baseDir}/scripts/jira.sh comment ABC-123 "text"— add a comment{baseDir}/scripts/jira.sh create "Title" ["Description"]— create a Task inJIRA_BOARD{baseDir}/scripts/jira.sh log ABC-123 2.5 [YYYY-MM-DD]— log hours (defaults to today UTC){baseDir}/scripts/jira.sh my [max]— open issues assigned to you{baseDir}/scripts/jira.sh hours 2025-01-01 2025-01-07— your logged hours by issue (JSON){baseDir}/scripts/jira.sh hours-day 2025-01-07 [name|email]— logged hours for a day grouped by user/issue; optional filter (name/email; also resolves to accountId){baseDir}/scripts/jira.sh hours-issue ABC-123 [name|email]— logged hours for an issue; optional filter (name/email; also resolves to accountId)Command Reference
- Search issues
bash {baseDir}/scripts/jira.sh link ABC-321
- Issue link
bash {baseDir}/scripts/jira.sh issue ABC-321
- Issue details
bash {baseDir}/scripts/jira.sh status ABC-321 "Done"
- Update status
bash {baseDir}/scripts/jira.sh transitions ABC-321
- List transitions
bash {baseDir}/scripts/jira.sh assign ABC-321 "Jane Doe"
- Assign issue
bash {baseDir}/scripts/jira.sh assign-me ABC-321
- Assign to yourself
bash {baseDir}/scripts/jira.sh comment ABC-321 "Deployed to staging"
- Add comment
bash {baseDir}/scripts/jira.sh create "Fix auth timeout" "Users being logged out after 5m"
- Create issue
bash {baseDir}/scripts/jira.sh log PB-321 1.5 2025-01-18
- Log hours
bash {baseDir}/scripts/jira.sh my [maxResults]
- My open issues
bash {baseDir}/scripts/jira.sh hours 2025-01-01 2025-01-05
- Logged hours by issue (me)
bash {baseDir}/scripts/jira.sh hours-day 2025-01-05
- Logged hours for a day (everyone)
bash {baseDir}/scripts/jira.sh hours-day 2025-01-05 "jane"
- Logged hours for a day (user filter)
bash {baseDir}/scripts/jira.sh hours-issue ABC-321 "jane" ``
- Logged hours for an issue
Notes
- Worklog commands use Jira's worklog/updated + worklog/list combo and may take a few seconds on large projects.
hoursfilters byJIRA_EMAIL;hours-day` returns all users with totals per issue and user.- Outputs for hours commands are JSON for reuse in other tools.
- Status transitions are validated against the server‑provided transition list before applying.