worklog-target.sh 新增 week 子命令,依週五所在月份輸出 yyyy-MM-Wn 工作週編號 #38

Merged
admin merged 1 commits from feat/worklog-target-week into develop 2026-09-08 03:15:10 +00:00
1 Commits
Author SHA1 Message Date
jiantw83andClaude Sonnet 5 deddd448a6 feat(log): worklog-target.sh 新增 week 子命令,輸出 yyyy-MM-Wn 工作週編號
因為 worklog 頁面內容是照週五整理的,需要一個能直接算出「這是當月第幾個工作週」
的指令,判斷基準是週五落在哪個月、當月第幾個週五,而不是 ISO 週次或週一所在月份。

新增 `worklog-target.sh week [基準日期 yyyy-MM-dd]`,重用既有 `friday`(週一加四天)
的邏輯算出週五日期,再往前推算當月第幾個週五,組成 `yyyy-MM-Wn` 格式輸出;同時把
`friday`/`week` 兩分支原本各自重複的基準日期格式檢查收進 `friday_of_week()` 內部,
消除重複程式碼,並補齊函式註解的層級標記、步驟條列與範例值,以及 usage() 說明中
原本漏掉的 week 用法。

已用 TDD 驗證跨月週與本週遞增兩種情境、跑過語法檢查與註解掃描,並經兩輪 code
review(六組壞味道)確認無殘留問題。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-08 11:03:45 +08:00