跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
搜索与研究

jira-time-tracking

Time tracking, worklogs, and time reports. TRIGGERS: 'log time', 'time spent on', 'log hours', 'log work', 'worklog', 'time tracking', 'timesheet', 'how much time', 'time logged', 'time report', 'export timesheet', 'set estimate', 'remaining estimate', 'original estimate'. Use for time-related queries and operations on issues. NOT FOR: SLA tracking (use jira-jsm), date-based issue searches (use jira-search), issue field updates unrelated to time (use jira-issue).

jira-assistant-skills · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add grandcamel/JIRA-Assistant-Skills --skill jira-time-tracking

技能说明


name: "jira-time-tracking" description: "Time tracking, worklogs, and time reports. TRIGGERS: 'log time', 'time spent on', 'log hours', 'log work', 'worklog', 'time tracking', 'timesheet', 'how much time', 'time logged', 'time report', 'export timesheet', 'set estimate', 'remaining estimate', 'original estimate'. Use for time-related queries and operations on issues. NOT FOR: SLA tracking (use jira-jsm), date-based issue searches (use jira-search), issue field updates unrelated to time (use jira-issue)." version: "1.0.0" author: "jira-assistant-skills" license: "MIT" allowed-tools: ["Bash", "Read", "Glob", "Grep"]

JIRA Time Tracking Skill

Risk Levels

OperationRiskNotes
View worklogs-Read-only
View time tracking-Read-only
Generate reports-Read-only
Export timesheets-Read-only (local file)
Log time-Easily reversible (can delete)
Update worklog!Previous value lost
Set estimates!Can update again
Bulk log time!Creates multiple worklogs
Delete worklog!!Time data lost, can re-log

Risk Legend: - Safe, read-only | ! Caution, modifiable | !! Warning, destructive but recoverable | !!! Danger, irreversible

When to use this skill

Use the jira-time skill when you need to:

  • Log time spent working on JIRA issues
  • View, update, or delete work log entries
  • Set or update time estimates (original and remaining)
  • Generate time reports for billing, invoicing, or tracking
  • Export timesheets to CSV or JSON format
  • Bulk log time across multiple issues

What this skill does

IMPORTANT: Always use the jira-as CLI. Never run Python scripts directly.

The jira-time skill provides comprehensive time tracking and worklog management:

Worklog Management

  • Add worklogs - Log time with optional comments and date/time
  • View worklogs - List all time entries for an issue
  • Update worklogs - Modify existing time entries
  • Delete worklogs - Remove time entries with estimate adjustment

Time Estimates

  • Set estimates - Configure original and remaining estimates
  • View time tracking - See complete time tracking summary with progress

Reporting

  • Time reports - Generate reports by user, project, or date range
  • Export timesheets - Export to CSV/JSON for billing systems
  • Bulk operations - Log time to multiple issues at once

Available Commands

CommandDescription
jira-as time logAdd a time entry to an issue
jira-as time worklogsList all worklogs for an issue
jira-as time update-worklogModify an existing worklog
jira-as time delete-worklogRemove a worklog entry
jira-as time estimateSet original/remaining time estimates
jira-as time trackingView time tracking summary
jira-as time reportGenerate time reports
jira-as time exportExport time data to CSV/JSON
jira-as time bulk-logLog time to multiple issues

All commands support --help for full documentation.

Common Options

All commands support these common options:

OptionDescriptionAvailability
-o/--outputOutput format: text (default), jsonlog, worklogs, update-worklog, delete-worklog, tracking, bulk-log
-f/--formatOutput format: text, json, csvreport (text/csv/json), export (csv/json only)
--helpShow help message with all available optionsAll commands

Note: For estimate, use the long form --output - on that command -o is short for --original. For export, -o/--output is the output file path (see export-specific options below).

Worklog-specific options

OptionDescription
-t/--time TIMETime spent (e.g., 2h, 1d 4h, 30m)
-c/--comment TEXTDescription of work performed
-s/--started DATEWhen work was started (default: now)
--adjust-estimate MODEHow to adjust remaining estimate: auto, leave, new, manual (see note below)
--new-estimate TIMENew remaining estimate (for adjust=new or adjust=manual)
--reduce-by TIMEAmount to reduce estimate (for adjust=manual with log)
--increase-by TIMEAmount to increase estimate (for adjust=manual with delete-worklog)
--visibility-type TYPEWorklog visibility: role or group
--visibility-value TEXTRole name or group name for visibility
-w/--worklog-id IDWorklog ID (for update/delete operations)

Note: The manual mode (with --reduce-by or --increase-by) is only available for log and delete-worklog commands. The update-worklog command supports only auto, leave, and new modes.

Worklog filter options

OptionDescription
-s/--since DATEStart date for filtering worklogs
-u/--until DATEEnd date for filtering worklogs
-a/--author USERFilter by worklog author

Report-specific options

OptionDescription
--period PERIODTime period: today, yesterday, this-week, last-week, this-month, last-month (YYYY-MM format is only accepted by export, not report)
-u/--user USERFilter by user (use currentUser() for yourself)
-p/--project PROJECTFilter by project key
-s/--since DATEStart date for filtering
--until DATEEnd date for filtering
-g/--group-by FIELDGroup results by: issue, day, or user

Export-specific options

OptionDescription
-o/--output FILEOutput file path (e.g., timesheets.csv)
-f/--format FORMATFile format: csv (default) or json

Bulk-log-specific options

OptionDescription
-j/--jql JQLJQL query to select issues
-i/--issues LISTComma-separated issue keys
-n/--dry-runPreview without makin
阅读完整来源 ↗