Files
log/skills/worklog/SKILL.md
T
2026-08-24 18:54:19 +08:00

3.0 KiB

name, description
name description
worklog After finishing a work package, collect ten facts (repo, branch, plan link, work package link, elapsed time from session-timer, token usage per CLI, status, details, difficulties, PR target) and append a templated entry to wiki LOG_{HASH} plus LOG_CONTENTS. HASH follows the shared 8-char rule with the H-prefix fallback, and the work-week Friday still drives the page content. Trigger at the end of implement or maintain; not for planning notes.

worklog — work log

After work completes, collect the ten items below and append a templates/log-entry.md entry to the wiki log page. Collection and writing MUST run as a sub agent. The entry content is written in Traditional Chinese (STE100).

Items to collect

# Item Source
1 Repository name Parse {owner}/{repo} from git remote get-url origin
2 Branch name git branch --show-current
3 Plan name Absolute link to the plan page: [PLAN_{HASH}](<url>), where <url> comes from jsc-gitea/tools/gitea.sh wiki-url {owner}/{repo} PLAN_{HASH} — PLAN and LOG may live in different wiki repos, and [[...]] only resolves inside one wiki
4 Work package id Absolute link to the work package heading: [WP-xx](<url>#wp-xx), <url> from gitea.sh wiki-url {owner}/{repo} ANALYZE_{HASH}
5 Elapsed time jsc-hooks/hooks/session-timer.sh report {session_id} (seconds; convert to h/m)
6 Token usage See the table below; per-CLI methods differ. Fill N/A when unavailable
7 Task status One of the literal values 「完成」、「部分完成」、「阻塞」 (with reason when blocked)
8 Details and outputs Summarize what changed and which files or pages were produced
9 Difficulties and resolutions One pair per line
10 PR target branch Link to the PR page

How to get token usage

CLI Method
claude Sum the usage fields in transcript JSONL (~/.claude/projects/**/*.jsonl), or read usage from claude -p --output-format json
codex Token counters under ~/.codex/sessions/**, or /status inside the session
copilot /usage inside the session
antigravity Value shown in the UI; N/A when unreadable
kiro No public source; fill N/A

Target page and work week

  • Page name: LOG_{HASH}.
  • Compute {HASH} from {owner}/{repo} with jsc-gitea/tools/hash-id (shared wiki hash rule: first 8 uppercase SHA-1 hex chars; H plus the first 7 chars when the raw hash starts with 0-9, A, B, or C).
  • Compute the target page by running tools/worklog-target.sh "{HASH}" all. Use PAGE for LOG_{HASH} and CONTENTS for LOG_CONTENTS.
  • The work-week Friday still drives the page content and the row dates.
  • Read the page via jsc-gitea:wiki. If it does not exist, create it with the structure described in templates/log-contents.md; otherwise APPEND the new entry at the end.
  • Update LOG_CONTENTS in the same pass (apply templates/log-contents.md; add the row if missing).