feat(report): 新增工作日誌總結技能
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: 工作日誌的期間總結。
This commit is contained in:
@@ -0,0 +1,7 @@
|
||||
# 報表目錄
|
||||
|
||||
> 由 `jsc-log:report` 維護。年、月、週、日各一頁；`HASH` 取 `{owner}/{repo}/{期間}`，算法與其他頁面共用。
|
||||
|
||||
| 報表頁 | 期間 | 最新一期 | 期數 | 最後更新 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| [[REPORT_{HASH}]] | {daily、weekly、monthly、yearly 四選一} | {最新一期的標籤} | {n} | {yyyy-MM-dd HH:mm} |
|
||||
@@ -0,0 +1,27 @@
|
||||
# 日報 {yyyy-MM-dd}
|
||||
|
||||
> 由 `jsc-log:report` 產生。資料來源：`LOG_CONTENTS` 列出的所有工作日誌頁，取工作日期落在 {yyyy-MM-dd} 當天的條目。
|
||||
> 專案要自訂格式，在工作目錄放一份 `.jsc/templates/report-daily.md` 就會蓋過這一份。
|
||||
|
||||
- 期間：{yyyy-MM-dd}（含）
|
||||
- 條目數：{n}
|
||||
- 涵蓋存取庫：{n}
|
||||
- 花費時間合計：{h} 小時 {m} 分
|
||||
|
||||
## 今天做完什麼
|
||||
|
||||
| 存取庫 | 工作包 | 摘要 | 狀態 | 花費時間 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| {owner}/{repo} | [WP-{編號}]({ANALYZE 頁絕對網址}#wp-{編號}) | {一句話} | {完成、部分完成、阻塞} | {h}h{m}m |
|
||||
|
||||
## 卡住的地方
|
||||
|
||||
| 存取庫 | 困難 | 目前處置 | 還缺什麼 |
|
||||
| --- | --- | --- | --- |
|
||||
| {owner}/{repo} | {困難} | {已做的處置} | {待解} |
|
||||
|
||||
> 沒有阻塞項目時，整張表寫一列「無」。
|
||||
|
||||
## 明天接著做
|
||||
|
||||
- {下一步，取自未完成條目的剩餘 todo}
|
||||
@@ -0,0 +1,48 @@
|
||||
# 月報 {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 |
|
||||
|
||||
## 逐週推進
|
||||
|
||||
```mermaid
|
||||
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} 天 | {下一步} |
|
||||
|
||||
## 下月重點
|
||||
|
||||
- {下一批工作包或維護項目}
|
||||
@@ -0,0 +1,39 @@
|
||||
# 週報 {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} | {原因，無阻塞寫「無」} |
|
||||
|
||||
## 下週重點
|
||||
|
||||
- {取自未完成條目與計畫頁的下一批工作包}
|
||||
@@ -0,0 +1,54 @@
|
||||
# 年報 {yyyy}
|
||||
|
||||
> 由 `jsc-log:report` 產生。資料來源：`LOG_CONTENTS` 列出的所有工作日誌頁，取工作日期落在 {start} 到 {end} 之間的條目。
|
||||
> 專案要自訂格式，在工作目錄放一份 `.jsc/templates/report-yearly.md` 就會蓋過這一份。
|
||||
|
||||
- 期間：{start} 到 {end}
|
||||
- 條目數：{n}
|
||||
- 涵蓋存取庫：{n}
|
||||
- 花費時間合計：{h} 小時
|
||||
- token 用量合計：{CLI}: {input}/{output}
|
||||
|
||||
## 全年總覽
|
||||
|
||||
| 存取庫 | 完成工作包 | 花費時間 | 佔比 | 最後一次動工 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| {owner}/{repo} | {n} | {h}h | {n}% | {yyyy-MM-dd} |
|
||||
|
||||
## 逐月推進
|
||||
|
||||
```mermaid
|
||||
xychart-beta
|
||||
title "每月完成工作包數"
|
||||
x-axis [01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12]
|
||||
y-axis "工作包" 0 --> {上限}
|
||||
bar [{n}, {n}, {n}, {n}, {n}, {n}, {n}, {n}, {n}, {n}, {n}, {n}]
|
||||
```
|
||||
|
||||
| 月份 | 條目數 | 完成 | 花費時間 | 主要里程碑 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| {yyyy-MM} | {n} | {n} | {h}h | {一句話} |
|
||||
|
||||
## 全年里程碑
|
||||
|
||||
| 日期 | 存取庫 | 里程碑 | 交付文件 |
|
||||
| --- | --- | --- | --- |
|
||||
| {yyyy-MM-dd} | {owner}/{repo} | {里程碑} | [{DELIVER 頁名}]({絕對網址}) |
|
||||
|
||||
## 全年教訓
|
||||
|
||||
> 取自 `LEARN_CONTENTS` 的教訓頁，只列同類重複三次以上、或造成整批工作停擺的那幾條。
|
||||
|
||||
| 教訓 | 出現次數 | 已改成什麼做法 |
|
||||
| --- | --- | --- |
|
||||
| {教訓} | {n} | {現行做法} |
|
||||
|
||||
## 年底未結
|
||||
|
||||
| 存取庫 | 工作包 | 狀態 | 卡多久 | 打算怎麼處理 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| {owner}/{repo} | WP-{編號} | {部分完成、阻塞} | {n} 天 | {處理方式} |
|
||||
|
||||
## 明年方向
|
||||
|
||||
- {取自計畫頁尚未動工的使用者故事}
|
||||
Reference in New Issue
Block a user