jiantw83
5e61528ad0
What：`worklog` 技能改成一個任務一筆條目，任務有三種——一個工作包、一輪 PR 留言修正、一個獨立的修正提交，並新增「What counts as one task」一表寫明各自何時結束；寫入步驟改走 `merge`、`commit`、`abort` 三段式，十項資訊裡的花費時間、token 用量、任務狀態、執行細節四項改成只算這一個任務。`templates/log-entry.md` 的頁首說明同步改寫。
Why：原本一個階段只寫一筆，同一個工作包跑五輪留言修正也只留下一筆。花費時間與 token 用量被攤成一個總數，看不出哪一輪花掉多少；連「試了卻沒改到檔案」的那一輪也整段消失，而那段時間正是最該被看見的。
How：下一個任務開始前先把這一筆寫完，五輪就是五筆，各自帶自己的花費時間與 token 用量，一律附加到同一頁 `LOG_{HASH}`，既有條目不動。每筆的標題要寫清楚是哪一個任務（工作包代號、第幾輪、或提交標題），五筆並排才讀得下去。花費時間在任務結束的當下讀，token 用量傳同一個 session id，兩個數字才描述同一件事。
Who：`jsc-sdlc:implement` 與 `jsc-sdlc:maintain` 收尾時呼叫日誌的每一個工作階段。
32 lines
1.5 KiB
Markdown
32 lines
1.5 KiB
Markdown
# 工作日誌頁 — LOG_{HASH}
|
||
|
||
> 由 `jsc-log:worklog` 維護。每完成一個任務就附加一個條目在文末，下一個任務開始前寫完。
|
||
> 任務有三種：一個工作包、一輪 PR 留言修正、一個獨立的修正提交。同一個工作包跑五輪留言修正就是五筆，
|
||
> 標題各自寫清楚是哪一輪，時間與 token 分開記。
|
||
> `HASH` 依共享規則計算；頁名不再寫入年月週數，但頁內仍依本工作週的週五整理內容。
|
||
> {PLAN 頁絕對網址}、{ANALYZE 頁絕對網址} 由 `jsc-gitea/tools/gitea.sh wiki-url` 取得——LOG 與 PLAN／ANALYZE 可能分屬不同存取庫，`[[頁名]]` 跨庫不通。
|
||
> 解不出 wiki 存取庫或頁面不存在時，該欄填「無」，其他欄照填。由 `maintain` 觸發的日誌本來就沒有計畫頁與分析頁。
|
||
|
||
---
|
||
|
||
## {yyyy-MM-dd HH:mm} {工作摘要一句話}
|
||
|
||
| 欄位 | 內容 |
|
||
| --- | --- |
|
||
| 存取庫名稱 | {owner}/{repo} |
|
||
| 分支名稱 | {branch} |
|
||
| 計畫名稱 | [{計畫名稱}]({PLAN 頁絕對網址}) |
|
||
| 工作包編號 | [WP-{編號} {工作包標題}]({ANALYZE 頁絕對網址}#wp-{編號}) |
|
||
| 花費時間 | {h} 小時 {m} 分（session-timer report） |
|
||
| token 用量 | {CLI}: {input}/{output}（不可得填 N/A） |
|
||
| 任務狀態 | 完成、部分完成、阻塞（{原因}）三選一 |
|
||
| PR 目標分支 | [{base 分支}]({PR URL}) |
|
||
|
||
### 執行細節與產出
|
||
|
||
- {做了什麼、產出哪些檔案或頁面}
|
||
|
||
### 遇到的困難與解決方式
|
||
|
||
- {困難} → {解決方式}
|