jiantw83
e6fafd4132
What: 新增 jsc-log:report，把工作日誌總結成年報、月報、週報或日報，寫進 wiki REPORT_{HASH}。另加 tools/report-range.sh 算期間、tools/report-template.sh 解析範本，以及四份報表範本與報表目錄範本。
Why: worklog 只記單筆工作，累積起來沒有工具看得出一週或一個月做了什麼、什麼在卡。要總結只能自己翻頁面加總。
How: 期間換算交給系統的 date，不自己算閏年與週界；週次採 ISO-8601。範本解析採工作目錄優先，.jsc/templates/report-{period}.md 蓋過技能自帶的那份，專案要換格式不必改技能。資料讀 LOG_CONTENTS 列出的所有日誌頁，取工作日期落在期間內的條目，只加總條目真的寫了的數字。
Who: 工作日誌的期間總結。
1.5 KiB
1.5 KiB
月報 {yyyy-MM}
由
jsc-log:report產生。資料來源：LOG_CONTENTS列出的所有工作日誌頁，取工作日期落在 {start} 到 {end} 之間的條目。 專案要自訂格式，在工作目錄放一份.jsc/templates/report-monthly.md就會蓋過這一份。
- 期間：{start} 到 {end}
- 條目數：{n}
- 涵蓋存取庫：{n}
- 花費時間合計：{h} 小時 {m} 分
- token 用量合計：{CLI}: {input}/{output}
本月成果
| 存取庫 | 完成工作包 | 部分完成 | 阻塞 | 花費時間 |
|---|---|---|---|---|
| {owner}/{repo} | {n} | {n} | {n} | {h}h{m}m |
逐週推進
xychart-beta
title "每週花費時間（小時）"
x-axis [{yyyy}-W{ww}, {yyyy}-W{ww}, {yyyy}-W{ww}, {yyyy}-W{ww}]
y-axis "小時" 0 --> {上限}
bar [{h}, {h}, {h}, {h}]
| 週次 | 條目數 | 完成 | 花費時間 | 主要進展 |
|---|---|---|---|---|
| {yyyy}-W{ww} | {n} | {n} | {h}h{m}m | {一句話} |
重複出現的困難
同一類困難出現兩次以上才列進來。只出現一次的留在週報，不往上滾。
| 困難 | 出現次數 | 影響存取庫 | 根因 | 對策 |
|---|---|---|---|---|
| {困難} | {n} | {owner}/{repo} | {根因} | {對策} |
月底未結
| 存取庫 | 工作包 | 狀態 | 卡多久 | 下一步 |
|---|---|---|---|---|
| {owner}/{repo} | WP-{編號} | {部分完成、阻塞} | {n} 天 | {下一步} |
下月重點
- {下一批工作包或維護項目}