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
| Operation | Risk | Notes |
|---|---|---|
| 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
| Command | Description |
|---|---|
jira-as time log | Add a time entry to an issue |
jira-as time worklogs | List all worklogs for an issue |
jira-as time update-worklog | Modify an existing worklog |
jira-as time delete-worklog | Remove a worklog entry |
jira-as time estimate | Set original/remaining time estimates |
jira-as time tracking | View time tracking summary |
jira-as time report | Generate time reports |
jira-as time export | Export time data to CSV/JSON |
jira-as time bulk-log | Log time to multiple issues |
All commands support --help for full documentation.
Common Options
All commands support these common options:
| Option | Description | Availability |
|---|---|---|
-o/--output | Output format: text (default), json | log, worklogs, update-worklog, delete-worklog, tracking, bulk-log |
-f/--format | Output format: text, json, csv | report (text/csv/json), export (csv/json only) |
--help | Show help message with all available options | All commands |
Note: For
estimate, use the long form--output- on that command-ois short for--original. Forexport,-o/--outputis the output file path (see export-specific options below).
Worklog-specific options
| Option | Description |
|---|---|
-t/--time TIME | Time spent (e.g., 2h, 1d 4h, 30m) |
-c/--comment TEXT | Description of work performed |
-s/--started DATE | When work was started (default: now) |
--adjust-estimate MODE | How to adjust remaining estimate: auto, leave, new, manual (see note below) |
--new-estimate TIME | New remaining estimate (for adjust=new or adjust=manual) |
--reduce-by TIME | Amount to reduce estimate (for adjust=manual with log) |
--increase-by TIME | Amount to increase estimate (for adjust=manual with delete-worklog) |
--visibility-type TYPE | Worklog visibility: role or group |
--visibility-value TEXT | Role name or group name for visibility |
-w/--worklog-id ID | Worklog ID (for update/delete operations) |
Note: The
manualmode (with--reduce-byor--increase-by) is only available forloganddelete-worklogcommands. Theupdate-worklogcommand supports onlyauto,leave, andnewmodes.
Worklog filter options
| Option | Description |
|---|---|
-s/--since DATE | Start date for filtering worklogs |
-u/--until DATE | End date for filtering worklogs |
-a/--author USER | Filter by worklog author |
Report-specific options
| Option | Description |
|---|---|
--period PERIOD | Time period: today, yesterday, this-week, last-week, this-month, last-month (YYYY-MM format is only accepted by export, not report) |
-u/--user USER | Filter by user (use currentUser() for yourself) |
-p/--project PROJECT | Filter by project key |
-s/--since DATE | Start date for filtering |
--until DATE | End date for filtering |
-g/--group-by FIELD | Group results by: issue, day, or user |
Export-specific options
| Option | Description |
|---|---|
-o/--output FILE | Output file path (e.g., timesheets.csv) |
-f/--format FORMAT | File format: csv (default) or json |
Bulk-log-specific options
| Option | Description |
|---|---|
-j/--jql JQL | JQL query to select issues |
-i/--issues LIST | Comma-separated issue keys |
-n/--dry-run | Preview without makin |