2.5 KiB
2.5 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 | Link to the plan page [[PLAN_{HASH}]] |
| 4 | Work package id | Link to the work package heading on the analyze page [[ANALYZE_{HASH}#WP-xx]] |
| 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 the target page by running
tools/worklog-target.sh "{owner}/{repo}" all. UsePAGEforLOG_{HASH}andCONTENTSforLOG_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 intemplates/log-contents.md; otherwise APPEND the new entry at the end. - Update
LOG_CONTENTSin the same pass (applytemplates/log-contents.md; add the row if missing).