Imported from yangsonhung/awesome-agent-skills (
skills/zh-cn/git-weekly-report-cn/SKILL.md). Install upstream withnpx skills add yangsonhung/awesome-agent-skills --skill git-weekly-report-cn. Copyright stays with the author.
Git 周/日报生成
Overview
提取 Git 提交日志并生成结构化日报或周报。输出会把近期工作整理为完成事项、进行中事项、重要事项、计划和风险阻塞，并支持按时间范围、作者和仓库维度汇总，便于复用到站会、日报、周报或项目汇总中。
何时使用
当用户有以下需求时使用本技能：
- 从 Git 提交记录生成周报或日报
- 总结昨天或今天的 Git 活动
- 汇总一个或多个仓库的近期 Git 活动
- 回顾某个时间段内完成的工作
- 将提交历史整理为分类报告
- 从提交记录准备每日站会汇总
不要使用
以下场景不应使用本技能：
- 对特定变更的代码审查（请使用 code-reviewer）
- 查看单条提交的详细信息
- 提取日志以外的 Git 操作（分支、合并等）
- 与 Git 无关的报告生成
使用说明
- 确定日期范围和报告类型：
- 日报：用户说"昨天"、"今天"、"日报"时 — 默认
--since为昨天，--until为今天 - 周报：用户说"这周"、"本周"、"周报"时 — 默认
--since为本周一，--until为今天 - 其他情况：默认最近 7 天。接受用户自定义。
- 日报：用户说"昨天"、"今天"、"日报"时 — 默认
- 确定作者过滤。如用户指定则使用，默认：全部作者。
- 确定仓库路径。默认：当前工作目录。如用户提及多个项目，收集所有路径。
- 运行脚本：
python3 scripts/git_weekly_report.py --since <YYYY-MM-DD> --until <YYYY-MM-DD> [--author <名称>] [--repo <路径1> <路径2> ...]- 读取 JSON 输出。脚本按仓库分组提供结构化提交数据。
- 使用 weekly-report-format.md 作为分类指南，按类型归类提交。
- 使用 weekly-report-template.md 作为输出结构生成最终周报。
- "下周计划"和"风险阻塞"板块：需向用户确认是否有内容补充，这些信息无法从 Git 日志推导。日报默认不含这些板块，除非用户要求。
- 呈现最终 Markdown 周报。如用户需要，保存到文件。
脚本使用
# 默认：最近 7 天，当前目录
python3 scripts/git_weekly_report.py
# 指定日期范围
python3 scripts/git_weekly_report.py --since 2026-04-21 --until 2026-04-28
# 指定作者
python3 scripts/git_weekly_report.py --since 2026-04-21 --author "Yang"
# 多个仓库
python3 scripts/git_weekly_report.py --since 2026-04-21 --repo /path/to/project-a /path/to/project-b
# 保存输出到文件
python3 scripts/git_weekly_report.py --since 2026-04-21 --output /tmp/weekly.json
# 包含 merge 提交
python3 scripts/git_weekly_report.py --since 2026-04-21 --mergesJSON 输出结构
脚本输出 JSON，结构如下：
date_range:{ since, until }— 查询的日期范围author_filter: 字符串或 null — 应用的作者过滤repositories:{ path, name, commit_count, commits }数组total_commits: 所有仓库的提交总数
每条提交包含：hash、short_hash、author、date、subject、body、refs。
周报生成
当单个仓库的提交数超过 50 条时，按类别汇总而非逐条列出。始终保留 short_hash 以便追溯。
"进行中的工作"板块，留意以下信号：WIP、TODO、临时方案、未合并的功能分支。
"重要事项"板块，识别：breaking change、安全修复、重大功能上线、涉及关键路径的提交。
