技能介绍

要解决什么问题

写周报时，常见难点不是“没有工作”，而是 Git 提交记录太碎：fix typo、update deps、多个仓库分散在不同目录，人工回忆和归类耗时。这个技能面向本地 Git 仓库的提交历史，把 commit message、仓库 README 中的项目中文名、时间范围和提交人信息整理成可编辑的周报条目，并给出初步耗时分配，减少从原始提交到周报条目的手工整理。

它如何工作

技能会扫描指定目录下的 Git 仓库，优先从 README.md 前 80 行识别中文项目名；如果识别不到，就回退到仓库名。随后按 --since 时间范围和可选 --author 提交人筛选提交，默认最近 7 天、所有提交人、总工时 5 天。核心输出遵循周报规则：

一条中文结果：每个事项写成一句简洁中文，末尾标注 0.5d、1d、2d 等耗时。
合并零散事项：同一平台下的简单小修复可合并，但单条最多合并 3 个事项。
忽略低价值噪音：拼写、格式化、依赖锁文件、普通 merge 等通常不进入周报，除非它们就是主要工作。
耗时守恒：所有事项合计需等于 --workdays，默认 5d，人工调整时优先改最大或最模糊条目。

适用边界

它适合本地仓库、中文周报场景，尤其是需要从 git log 提炼工作结果的项目。若提交信息长期只有 update、fix 等弱描述，脚本只能给出较粗略的归类，仍需结合代码改动或需求背景润色。它也不适合需要按工时系统、审批流或公司模板自动归档的场景；输出更像初稿，需要工程师确认项目名、事项粒度和耗时。