前言¶
周报里最耗时的往往不是写,而是汇总:团队通常有多个仓库,提交散在不同目录,还要按人、按事项、按工时归拢,最后摊到一周的格子里。人工做这件事容易漏仓库,也容易把时间算错。
下面介绍的 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