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.7 KiB
1.7 KiB
年報 {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} |
逐月推進
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} 天 | {處理方式} |
明年方向
- {取自計畫頁尚未動工的使用者故事}