前言¶
週報裏最耗時的往往不是寫，而是彙總：團隊通常有多個倉庫，提交散在不同目錄，還要按人、按事項、按工時歸攏，最後攤到一週的格子裏。人工做這件事容易漏倉庫，也容易把時間算錯。
下面介紹的 Skill 把這套流程交給 Agent 執行：給定一個目錄和時間範圍，它掃描目錄下所有 git 倉庫，分析提交記錄，再爲指定提交人生成中文週報。
這是什麼¶
「週報總結skill」是一個基於通用 SKILL.md 格式編寫的 Agent Skill，座標 @user_fff6db65/git-weekly-report-skill，版本 1.0.0，發佈者 user_fff6db65，來源標記爲 community，分類 office-efficiency。
它解決的問題是：把「最近一週的提交情況」變成一份可以直接提交的中文週報，中間包含倉庫掃描、提交分析、工時估算、工時分配、工時歸一這幾個步驟。
Skill 頁面上的評分爲 100000，下載 1096 次，安裝數 0。
核心功能¶
1、掃描指定目錄下的所有 git 倉庫，目錄裏有幾個倉庫就掃幾個，不需要逐個指定。
2、按時間範圍取提交，默認最近一週，也可以指定其他範圍。
3、按 git 提交人彙總，可以只針對某一位提交人輸出，其他人的提交不進入週報。
4、估算事項耗時，並按 0.5 天粒度分配工時。
5、工時歸一，將總工時歸一到默認的 5 天工作周。
6、輸出中文週報，前面的分析、彙總、估算、分配結果最終都以中文呈現。
這六項與官方簡介一致。簡介原文列出的可觸發能力是：掃描倉庫、分析 git 提交、生成周報、寫週報、統計最近一週 commit、按提交人彙總工作、估算事項耗時、按 0.5 天粒度分配工時，或將總工時歸一到默認 5 天工作周。
安裝與啓用¶
官方地址：
https://api.skillhub.cn/user_fff6db65/git-weekly-report-skill
SkillHub 頁面：
https://www.skillhub.cn/skills/user_fff6db65/git-weekly-report-skill
Skill 標籤中有一項 requires_api_key=false，表示它不需要額外配置 API Key，裝好即可調用。
安裝命令這一點需要說明：已抓取資料裏沒有給出可覈對的命令文本，只有座標 @user_fff6db65/git-weekly-report-skill。本文寫作時上述頁面與接口地址均無法訪問，因此不在這裏給出命令，避免寫出無法驗證的安裝步驟。
啓用方式上，該 Skill 遵循通用 SKILL.md 格式，在支持該格式的客戶端中註冊後即可使用。至於 Cursor、Codex CLI、Claude Code 各自的安裝路徑與配置差異，本次資料中沒有可覈對的說明，暫不展開。
典型用法¶
按官方簡介，觸發方式是自然語言，中文或英文均可。下面幾句是簡介中列出的觸發說法，可以直接使用：
- 掃描倉庫
- 分析 git 提交
- 生成周報、寫週報
- 統計最近一週 commit
- 按提交人彙總工作
- 估算事項耗時
- 按 0.5 天粒度分配工時
- 將總工時歸一到默認 5 天工作周
關於輸入要素，官方簡介提到了三樣：指定目錄、指定時間範圍、指定 git 提交人，其中缺省項是「最近一週」。據此可以推斷，一條請求至少要包含目錄和提交人，時間範圍不寫就取最近一週。這是本文的推斷，官方沒有給出完整調用示例，實際使用時請以調用結果爲準。
另外需要注意，工時是由提交記錄估算出來的，不是工時表裏填報的數字。如果某人這一週只有零散的小提交，估算出的工時會偏低，週報上表現爲半天格子沒填滿。5 天工作周的歸一是對總量的調整，不改變單項估算本身。
適用場景與注意¶
適合的場景：
1、一個人同時維護多個倉庫，需要把一週工作壓成一份週報。
2、多人共用一個目錄，提交混在一起，需要按人拆開看。
3、想按 0.5 天粒度看工作量分佈，而不是隻羅列提交標題。
需要注意的地方：
1、它統計的是提交（commit），不是任務或工單。合併、回滾、文檔改動都會被計入，顆粒度取決於倉庫實際的提交習慣。
2、提交歸屬按 git 提交人（author）識別。如果歷史上存在多人共用同一個提交人郵箱的情況，這些提交會被合併到同一個人名下。
3、「最近一週」指自然周還是滾動 7 天，資料中沒有明確說明，使用前建議先確認。
4、版本爲 1.0.0，來源標記爲 community，屬社區發佈，更新節奏和後續維護需要自行判斷。
5、安裝細節本次無法覈實，上文給出的地址與座標來自抓取資料，命令部分請到 SkillHub 頁面二次確認。
結尾¶
這個 Skill 的價值在於拿走週報中最機械的那部分：找倉庫、翻提交、按人彙總、估工時、攤到 0.5 天粒度、歸一到 5 天。它不改變週報結論的來源——工時仍然來自提交記錄——因此更適合提交習慣比較規範的團隊。如果倉庫提交很碎，或者存在多人共用郵箱的情況，先整理提交記錄再用，結果會更準。
官方地址：https://api.skillhub.cn/user_fff6db65/git-weekly-report-skill
SkillHub 頁面：https://www.skillhub.cn/skills/user_fff6db65/git-weekly-report-skill
