Git weekly report cn

Skill YangsonHung/awesome-agent-skills/skills/zh-cn/git-weekly-report-cn

A collection of AI Agent Skills that provide professional domain capabilities for intelligent assistants like Claude Code.

Install

npx -y skills add YangsonHung/awesome-agent-skills --skill git-weekly-report-cn

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

当用户需要把 Git 提交记录整理成结构化日报、周报或工作汇总时使用。

SKILL.md

3.6 KB, as published. Nobody here has run it

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 --merges

JSON 输出结构

脚本输出 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、安全修复、重大功能上线、涉及关键路径的提交。