docs(log): translate SKILL.md into English per guidelines
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
+26
-26
@@ -3,43 +3,43 @@ name: worklog
|
||||
description: 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_{yyyyMM}_W{week} plus LOG_CONTENTS. Week number is derived from the Friday of the work week. Trigger at the end of implement or maintain; not for planning notes.
|
||||
---
|
||||
|
||||
# worklog — 工作日誌
|
||||
# worklog — work log
|
||||
|
||||
工作完成後蒐集以下十項資訊,套用 `templates/log-entry.md` 附加到 wiki 日誌頁。蒐集與寫入**必須以 sub agent 執行**。
|
||||
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 | 存取庫名稱 | `git remote get-url origin` 解析出 `{owner}/{repo}` |
|
||||
| 2 | 分支名稱 | `git branch --show-current` |
|
||||
| 3 | 計畫名稱 | 連結到計畫頁 `[[PLAN_{...}]]` |
|
||||
| 4 | 工作包編號 | 連結到分析頁的工作包標題 `[[ANALYZE_{...}#WP-xx]]` |
|
||||
| 5 | 花費時間 | `jsc-hooks/hooks/session-timer.sh report {session_id}`(秒,換算 h/m) |
|
||||
| 6 | token 用量 | 見下表,各 CLI 取法不同;不可得填 `N/A` |
|
||||
| 7 | 任務狀態 | 完成 / 部分完成 / 阻塞(附原因) |
|
||||
| 8 | 執行細節與產出 | 摘要改了什麼、產出哪些檔案或頁面 |
|
||||
| 9 | 遇到的困難與解決方式 | 一行一組 |
|
||||
| 10 | PR 的目標分支 | 連結到 PR 頁 |
|
||||
| 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_{...}]]` |
|
||||
| 4 | Work package id | Link to the work package heading on the analyze page `[[ANALYZE_{...}#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 |
|
||||
|
||||
### token 用量取得方式
|
||||
### How to get token usage
|
||||
|
||||
| CLI | 取法 |
|
||||
| CLI | Method |
|
||||
| --- | --- |
|
||||
| claude | transcript JSONL(`~/.claude/projects/**/*.jsonl`)的 `usage` 欄位加總,或 `claude -p --output-format json` 的 `usage` |
|
||||
| codex | `~/.codex/sessions/**` 的 token 計數,或工作階段內 `/status` |
|
||||
| copilot | 工作階段內 `/usage` |
|
||||
| antigravity | 介面顯示值;無法讀取時 `N/A` |
|
||||
| kiro | 無公開來源,填 `N/A` |
|
||||
| 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 week number
|
||||
|
||||
- 頁名:`LOG_{yyyyMM}_W{週數}`,兩者都取自**本工作週的週五**:
|
||||
- Page name: `LOG_{yyyyMM}_W{週數}`. Both values come from the Friday of the current work week:
|
||||
```sh
|
||||
dow=$(date +%u)
|
||||
if [ "$dow" -ge 6 ]; then f=$(date -d 'last friday' +%Y%m%d); else f=$(date -d 'friday' +%Y%m%d); fi
|
||||
yyyyMM=$(printf '%s' "$f" | cut -c1-6)
|
||||
W=$(( ( $(printf '%s' "$f" | cut -c7-8 | sed 's/^0//') - 1 ) / 7 + 1 )) # 該週五是當月第幾個週五
|
||||
W=$(( ( $(printf '%s' "$f" | cut -c7-8 | sed 's/^0//') - 1 ) / 7 + 1 )) # which Friday of the month
|
||||
```
|
||||
- 經由 `jsc-gitea:wiki` 讀取該頁;不存在就以 `templates/log-contents.md` 說明的結構新建,存在就把新條目**附加**在文末。
|
||||
- 同步更新 `LOG_CONTENTS`(套用 `templates/log-contents.md`,該週的列不存在就新增)。
|
||||
- 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 week's row if missing).
|
||||
|
||||
Reference in New Issue
Block a user