worklog

Worklog

Personal work review, integrating local git statistics, GitHub, and Yunxiao data, outputting a structured Markdown report.

Prerequisites

Tool	Type	Required	Install
git	cli	Yes	brew install git or git-scm.com
gh	cli	No	brew install gh then gh auth login
jq	cli	No	brew install jq
yunxiao	skill	No	Included in npx skills add niracler/skill
yunxiao MCP	mcp	No	See yunxiao skill for setup

Do NOT proactively verify these tools on skill load. If a command fails due to a missing tool, directly guide the user through installation and configuration step by step.

Mode Selection

User says	Mode
「日报」「今天做了什么」"daily worklog"	Daily
「周报」「本周总结」"weekly worklog"	Weekly
「工作回顾」「worklog」	Ask user

Workflow

1. Determine mode + dates → 2. Collect data (parallel) → 3. Integrate + render

If no data from any source, output: "No activity recorded for {period}."

Step 1: Determine Dates

Mode	--since	--until
Daily	Today (YYYY-MM-DD)	Today
Weekly	Monday of current week	Today

Step 2: Collect Data (Parallel)

Run all three sources concurrently using subagents:

Other agent environments: the three sources are independent — run them sequentially if parallel execution is not available.

┌─ Bash: stats.sh --since {since} --until {until}       (local git)
├─ Bash: github.sh --since {since} --until {until}      (GitHub)
└─ subagent: 云效 MR/Bug/Task                            (yunxiao skill)

2a. Local Git Statistics

bash scripts/stats.sh --since YYYY-MM-DD --until YYYY-MM-DD

Output: JSON with period, repos[] (name, path, remote_url, commits, insertions, deletions, files_changed, authors, first_commit, last_commit), and totals (repos_active, repos_scanned, commits, insertions, deletions).

Other agent environments: run this command directly via shell.

2b. GitHub Activity

bash scripts/github.sh --since YYYY-MM-DD --until YYYY-MM-DD

Output: JSON with period, prs[] (repo, number, title, state, created_at, merged_at), issues[] (repo, number, title, state, created_at), and totals (prs_merged, prs_open, issues_opened, issues_closed).

Username is auto-detected via gh api user. No manual configuration needed.

Other agent environments: run this command directly via shell.

2c. Yunxiao Activity

Start subagent to invoke yunxiao skill with specific MCP queries:

Task tool:
- subagent_type: general-purpose
- prompt: 使用 yunxiao skill 获取 {since} 到 {until} 的工作记录

  先通过 MCP 自动获取身份：
  - get_current_user → 用户名
  - get_current_organization_info → 组织 ID

  然后查询：
  1. MR: list_change_requests — state=all, authorCodeupIdList=[user_id]
     返回: id, title, state, sourceRef, targetRef, createTime, mergeTime
  2. Bug: search_workitems — category=Bug, space=..., conditions=[assignee=username]
     返回: identifier, subject, status, assignedTo, gmtModified
  3. 任务: search_workitems — category=Task, space=..., conditions=[assignee=username]
     返回: identifier, subject, status, assignedTo, gmtModified

Other agent environments: if yunxiao skill is unavailable, skip and note "Yunxiao data not retrieved".

Step 3: Integrate and Render

Merge all sources. For any failed source, note it (e.g., "GitHub data not retrieved") and continue with available data.

Render using template.md.

Weekly mode additionally requires:

1. Commit distribution — For active repos from stats.sh, count commits per weekday:

   git log --since={since} --until={until_next_day} --author="{author}" --format="%aI" | \
     awk -F'T' '{print $1}' | sort | uniq -c
   

   Render as ASCII bar chart (Mon–Fri).

2. Highlights — From stats.sh data: most active repo (by commits), largest change (by insertions).

Data Source Degradation

Source failed	Behavior
GitHub	Note "GitHub data not retrieved", continue
Yunxiao	Note "Yunxiao data not retrieved", continue
Both remote	Output local git stats only

Common Issues

Issue	Fix
stats.sh empty repos	Check date range and --author filter
github.sh fails / 401	Run gh auth login
Yunxiao MCP not connected	Check MCP server configuration

Identity Detection

All user identities are auto-detected at runtime. See user-config.md for detection sources and prerequisites.