用途:在 JIRA 中记录工时、管理工作日志与时间估算,并生成用于计费或统计的工时报告。始终使用 jira-as CLI 操作,不要直接运行 Python 脚本。
主要能力:日志管理(新增、查看、更新、删除工作日志);时间估算(设置原始与剩余估算、查看跟踪摘要);报告与导出(按用户/项目/日期范围生成报告,导出 CSV/JSON);批量记录(按 JQL 或问题键列表批量写入工时)。
常用命令:jira-as time log、worklogs、update-worklog、delete-worklog、estimate、tracking、report、export、bulk-log。所有命令支持 --help。输出格式用 -o/--output(text/json 等),报告与导出用 -f/--format(csv/json)。
时间格式:30m、2h、1d(默认 8 小时)、1w(默认 5 天),可组合如 2d 4h 30m;不接受 2 hours、1.5h 等写法。
风险提示:查看类为只读;新增工时易撤销;更新工作日志会覆盖旧值;设置估算可再改;批量记录会创建多条;删除工作日志为破坏性但可重新记录。批量与删除前应先用 -n/--dry-run 预览。
限制:需项目启用时间跟踪,否则会报错;需相应权限(浏览项目、处理问题、编辑/删除所有工作日志等);报告不接受 YYYY-MM 作为 --period,导出可以;JIRA Cloud 存在估算更新问题 JRACLOUD-67539,可同时设置原始与剩余估算规避;报告不显示工时时检查 --started 日期与筛选条件。