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: 工作日誌的期間總結。
40 lines
1.3 KiB
Markdown
40 lines
1.3 KiB
Markdown
# 週報 {yyyy}-W{ww}
|
|
|
|
> 由 `jsc-log:report` 產生。資料來源：`LOG_CONTENTS` 列出的所有工作日誌頁，取工作日期落在 {start} 到 {end} 之間的條目。
|
|
> 週次採 ISO-8601，週一起算、週日結束。專案要自訂格式，在工作目錄放一份 `.jsc/templates/report-weekly.md` 就會蓋過這一份。
|
|
|
|
- 期間：{start} 到 {end}
|
|
- 條目數：{n}
|
|
- 涵蓋存取庫：{n}
|
|
- 花費時間合計：{h} 小時 {m} 分
|
|
- token 用量合計：{CLI}: {input}/{output}
|
|
|
|
## 本週產出
|
|
|
|
| 存取庫 | 工作包 | 摘要 | 狀態 | 花費時間 | PR |
|
|
| --- | --- | --- | --- | --- | --- |
|
|
| {owner}/{repo} | [WP-{編號}]({ANALYZE 頁絕對網址}#wp-{編號}) | {一句話} | {完成、部分完成、阻塞} | {h}h{m}m | [{base 分支}]({PR URL}) |
|
|
|
|
## 各存取庫用時分布
|
|
|
|
```mermaid
|
|
pie title 本週花費時間（分鐘）
|
|
"{owner}/{repo}" : {分鐘}
|
|
```
|
|
|
|
## 困難與解法
|
|
|
|
| 困難 | 解決方式 | 是否已解 |
|
|
| --- | --- | --- |
|
|
| {困難} | {解法} | {是、否} |
|
|
|
|
## 未完成，滾到下週
|
|
|
|
| 存取庫 | 工作包 | 剩下什麼 | 阻塞原因 |
|
|
| --- | --- | --- | --- |
|
|
| {owner}/{repo} | WP-{編號} | {剩餘 todo} | {原因，無阻塞寫「無」} |
|
|
|
|
## 下週重點
|
|
|
|
- {取自未完成條目與計畫頁的下一批工作包}
|