jira-worklog-review

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Jira Worklog Review

Jira工作日志审核

Use this skill to review Jira worklog for a target day, compute total logged time, and close the 8-hour gap with either existing issues or a create-new-issue workflow.

使用此技能可审核指定日期的Jira工作日志，计算总记录时长，并通过关联现有议题或创建新议题的流程来填补8小时的时长缺口。

Trigger Phrases

触发短语

"Review my worklog"
"Check my jira hours"
"Did I log enough time today?"
"Review worklog for [date]"
"Suggest what to log if I am under 8h"
"Create a new Jira task and log work"

"审核我的工作日志"
"检查我的Jira工时"
"我今天的工时记录够8小时了吗？"
"审核[日期]的工作日志"
"如果我记录的工时不足8小时，推荐我应该记录哪些内容"
"创建新的Jira任务并记录工时"

Tools

工具

This skill relies on Atlassian Jira MCP (Jira toolset):

```
mcp_mcp-atlassian_jira_search
```
```
mcp_mcp-atlassian_jira_get_worklog
```
```
mcp_mcp-atlassian_jira_get_user_profile
```
(optional)
```
mcp_mcp-atlassian_jira_add_worklog
```
```
jira_search_fields
```
```
jira_get_field_options
```
Jira create issue tool in the same MCP set (for creating issues in
```
TL
```
)

此技能依赖Atlassian Jira MCP（Jira工具集）：

```
mcp_mcp-atlassian_jira_search
```
```
mcp_mcp-atlassian_jira_get_worklog
```
```
mcp_mcp-atlassian_jira_get_user_profile
```
（可选）
```
mcp_mcp-atlassian_jira_add_worklog
```
```
jira_search_fields
```
```
jira_get_field_options
```
同一MCP集中的Jira创建议题工具（用于在
```
TL
```
项目中创建议题）

Preconditions

前置条件

User can access Jira and has permission to read issues/worklogs.
User can create issues in project
```
TL
```
and log work.
Field
```
(BU) Project
```
exists as custom field
```
customfield_10232
```
.

用户可访问Jira，且拥有读取议题/工作日志的权限。
用户可在
```
TL
```
项目中创建议题并记录工时。
存在自定义字段
```
customfield_10232
```
，对应“(BU) 项目”字段。

Guardrails

约束规则

Default to read/analyze first; only create issue or add worklog after explicit confirmation from user input.
Keep date explicit (
```
YYYY-MM-DD
```
) and compute total by
```
timeSpentSeconds
```
.
If under 8h, keep iterating suggestions/actions until total reaches or exceeds 8h, or user stops.
If a required Jira tool call fails, show the exact failed step and ask for the minimum missing info/permission.

默认先进行读取/分析；仅在用户明确确认后，才创建议题或添加工作日志。
日期需明确为
```
YYYY-MM-DD
```
格式，通过
```
timeSpentSeconds
```
计算总时长。
如果工时不足8小时，持续提供推荐/操作建议，直到总时长达到或超过8小时，或用户停止操作。
如果必要的Jira工具调用失败，显示具体失败步骤，并请求用户提供最少的缺失信息/权限。

Workflow Router

工作流路由

Resolve inputs:
- ```
date
```
  (default: today)
- ```
user
```
  (default:
```
currentUser()
```
  , resolve accountId when filtering worklog entries)

Load

references/workflows/01-review-daily-worklog.md

If total

< 8h

, load

references/workflows/02-suggestions-under-8h.md

If user chooses create-new flow, load

references/workflows/03-create-issue-and-log-work.md

Repeat suggestion loop until total
```
>= 8h
```
or user stops.

Render final response using

references/templates/worklog-review-response-template.md

解析输入：
- ```
date
```
  （默认值：今日）
- ```
user
```
  （默认值：
```
currentUser()
```
  ，筛选工作日志条目时解析accountId）

加载

references/workflows/01-review-daily-worklog.md

。

如果总时长

< 8h

，加载

references/workflows/02-suggestions-under-8h.md

。

如果用户选择创建新议题流程，加载

references/workflows/03-create-issue-and-log-work.md

。

重复推荐循环，直到总时长
```
>= 8h
```
或用户停止。

使用

references/templates/worklog-review-response-template.md

渲染最终响应。

Minimal Response Contract

最小响应约定

Always return:

```
Date
```
: target review date.
```
Total logged
```
: hours and minutes.
```
Gap to 8h
```
: remaining duration (or
```
0
```
).
```
Actions taken
```
: issue keys logged/created and durations.
```
Next options
```
: continue suggestions loop or stop.

始终返回以下内容：

```
日期
```
：目标审核日期。
```
已记录总时长
```
：小时和分钟。
```
与8小时的缺口
```
：剩余时长（或
```
0
```
）。
```
已执行操作
```
：已记录/创建的议题编号及时长。
```
后续选项
```
：继续推荐循环或停止。

Failure Handling

故障处理

```
(BU) Project
```
field not found or mismatched metadata: stop create-new flow, show returned fields, and ask user/admin to confirm field mapping.
No available
```
(BU) Project
```
options: stop create flow and request Jira configuration check.
Create issue or add worklog failed: report exact tool step and error, then offer existing-issue logging as fallback.

未找到“(BU) 项目”字段或元数据不匹配：停止创建新议题流程，显示返回的字段，并请求用户/管理员确认字段映射。
无可用的“(BU) 项目”选项：停止创建流程，请求检查Jira配置。
创建议题或添加工作日志失败：报告具体工具步骤和错误，然后提供关联现有议题记录工时作为备选方案。