fix(worklog): 週頁改為星期六起算,換頁與星期對齊

舊規則以 ceil(日/7) 分週,換頁點固定落在每月 8/15/22/29 號,會把同一個
工作週切成兩頁(例:2026/07/28 二 在 W4、07/29 三 卻跳到 W5)。使用者開著
舊頁時看不到新條目,會誤判成 worklog 停止記錄。

- 週以星期六起算(六~五),週頁以該週起始的星期六為錨點命名
- W<n> 的 n =該星期六是當月第幾個星期六,頁名格式不變,舊頁照樣可讀
- 跨月的一週歸屬起始星期六所在月份,確保同一週只有一頁
  (2026/08/29 六 ~ 09/04 五 全部寫入 Worklog-2026-08-W5)
- 頁首標題補上日期範圍,開頁即可看出涵蓋哪幾天,避免再次誤判
- week_page_header 原本收了 page 卻不使用,一律以當下時間算標題,手動補寫
  舊頁時會寫錯週;改為從頁名反推所屬週
- 同步 SKILL.md 與 README.md 的分週說明

驗證:2026/01/01 ~ 2027/12/31 每日「頁名 → 反推週起始日」全部一致(0 筆不符),
月初、月末與跨月邊界皆正確。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Jeffery
2026-07-29 19:09:18 +08:00
co-authored by Claude Opus 5
parent 814e81e037
commit 975ac7886e
3 changed files with 63 additions and 12 deletions
+4 -2
View File
@@ -148,8 +148,10 @@ GITEA_TOKEN →(對目標 host 驗證失敗時)→ tea 設定檔中該 host
## 條目與頁面格式
- 週頁名稱:`Worklog-<yyyy>-<MM>-W<該月第幾週>`,第幾週 `ceil(日/7)`(例:`2026/07/27``Worklog-2026-07-W4`
- 頁首標題:`# <yyyy><MM> 月 第 <週> 週工作紀錄`
- **週以星期六起算(六~五)**,因此換頁一律發生在星期六,與星期對齊
- 週頁名稱:`Worklog-<yyyy>-<MM>-W<n>``n` =該週起始的星期六是當月第幾個星期六(例:`2026/07/29 三` 屬於 `07/25 六` 那一週 → `Worklog-2026-07-W4`
- 跨月的一週歸屬**起始星期六**所在的月份,確保同一週只有一頁(例:`2026/08/29 六 09/04 五` 全部寫入 `Worklog-2026-08-W5`)。
- 頁首標題:`# <yyyy> 年 <MM> 月 第 <n> 週工作紀錄(<起始日> 六 <結束日> 五)`,日期範圍讓人一眼看出這頁涵蓋哪幾天。
- 每筆條目:`## <時間> — <專案>` +六個固定 bullet(專案/任務名稱、執行細節與產出、花費時間、任務狀態、遇到的困難、解決方式);標題行尾帶 HTML 註解 marker`<!-- worklog:… -->`)供寫後驗證與去重,wiki 渲染時不顯示。
- 多 session 同時寫入:`append_entry` 採「讀取 → 合併 → 寫回 → 寫後讀取驗證 marker」,未落地則重讀最新內容重試,最多 3 次。