周报助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-m6xe1azv/0514-tosr2-skill-1。
技能介绍
先解决一个问题:周报不该靠回忆
写周报最耗时的部分往往不是组织语言,而是回忆这周到底做了什么。尤其是同时维护多个仓库的开发者,对着空白文档回想一周的提交记录,既容易遗漏,也容易把琐碎的 fix typo 和真正重要的架构调整混在一起。周报助手的思路很简单:让 Git 历史说话。它直接读取本地仓库过去 7 天的提交,把零散的 commit 整理成 3 条有信息量的总结,而不是把日志原样贴给你。
核心能力与工作流程
技能的工作流分为四步:
- 抓取提交记录:调用
scripts/get_git_logs.py,脚本内部执行git log,按git config user.name过滤出属于当前用户的提交,并自动排除 merge commit,只看过去 7 天的内容。 - 阅读与筛选:获取提交哈希、日期和 commit message 的 Subject 行,逐条阅读。
- 归类与聚焦:把提交按功能模块或任务目标分组,识别出本周最重要的 3 项成果或进展。琐碎提交(如
fmt、拼写修复)通常会被忽略,除非它们本身就是某项主要工作的组成部分。 - 输出周报:按固定格式输出 3 点总结,每点包含具体内容、进展或后续计划。
适用边界与注意点
这个技能的能力边界也很明确。它依赖本地 Git 仓库的提交历史,所以刚入职还没提交过代码的开发者、本周纯做文档或会议协作的人,可能凑不齐 3 条实质内容。提交信息的质量直接决定输出质量——如果你习惯写 update 或 wip 这类无信息量的 message,归类结果会很勉强。另外,它只处理当前仓库的提交,跨仓库的协作成果需要你自己合并说明。建议在用之前先确认 git config user.name 配置正确,否则脚本可能过滤不到你的提交。
使用场景
- 周五下班前需要向主管汇报本周工作,不想手动翻看git log整理进度,用该技能自动抓取本周提交并生成3点总结。
- 同时维护多个微服务仓库,写周报时容易遗漏核心功能迭代,利用该技能快速从git提交历史中提取3项关键进展。
- 刚结束一个敏捷开发周期,需要复盘上周的代码合入情况,通过运行脚本获取过去7天的非合并提交并自动归类输出。
适合人员
- 后端工程师,每周五需要汇总个人在多个微服务仓库的代码合入情况,向主管提交进度汇报。
- 全栈开发者,平时习惯使用git管理代码,写周报时不想回忆琐碎的bug修复,希望快速提炼3项核心业务产出。
- 开源项目维护者,需要在社区周会中分享本周的个人代码贡献,借助工具从本地git历史自动生成结构化的汇报。