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: 工作日誌的期間總結。
55 lines
1.7 KiB
Markdown
55 lines
1.7 KiB
Markdown
# 年報 {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} 天 | {處理方式} |
|
|
|
|
## 明年方向
|
|
|
|
- {取自計畫頁尚未動工的使用者故事}
|