Git Weekly Report Cn

---
name: git-weekly-report-cn
description: 将 Git 提交日志汇总为结构化周报或日报，包含完成工作、进行中事项、重要事项、计划和风险阻塞。用于用户要求生成周报、日报、总结昨天的提交、回顾今天做了什么、汇总近期 Git 活动、按项目分类提交记录。触发词包括：git log、提交历史、commit、日报、周报、昨天做了什么、今天的工作、总结昨天、本周工作、git活动、提交记录、每日站会、工作汇总。
---

# Git 周/日报生成

提取 Git 提交日志并生成结构化周报或日报。

## 何时使用

当用户有以下需求时使用本技能：
- 从 Git 提交记录生成周报或日报
- 总结昨天或今天的 Git 活动
- 汇总一个或多个仓库的近期 Git 活动
- 回顾某个时间段内完成的工作
- 将提交历史整理为分类报告
- 从提交记录准备每日站会汇总

## 不要使用

以下场景不应使用本技能：
- 对特定变更的代码审查（请使用 code-reviewer）
- 查看单条提交的详细信息
- 提取日志以外的 Git 操作（分支、合并等）
- 与 Git 无关的报告生成

## 使用说明

1. 确定日期范围和报告类型：
   - **日报**：用户说"昨天"、"今天"、"日报"时 — 默认 `--since` 为昨天，`--until` 为今天
   - **周报**：用户说"这周"、"本周"、"周报"时 — 默认 `--since` 为本周一，`--until` 为今天
   - 其他情况：默认最近 7 天。接受用户自定义。
2. 确定作者过滤。如用户指定则使用，默认：全部作者。
3. 确定仓库路径。默认：当前工作目录。如用户提及多个项目，收集所有路径。
4. 运行脚本：

```bash
python3 scripts/git_weekly_report.py --since <YYYY-MM-DD> --until <YYYY-MM-DD> [--author <名称>] [--repo <路径1> <路径2> ...]
```

5. 读取 JSON 输出。脚本按仓库分组提供结构化提交数据。
6. 使用 [weekly-report-format.md](references/weekly-report-format.md) 作为分类指南，按类型归类提交。
7. 使用 [weekly-report-template.md](assets/templates/weekly-report-template.md) 作为输出结构生成最终周报。
8. "下周计划"和"风险阻塞"板块：需向用户确认是否有内容补充，这些信息无法从 Git 日志推导。日报默认不含这些板块，除非用户要求。
9. 呈现最终 Markdown 周报。如用户需要，保存到文件。

## 脚本使用

```bash
# 默认：最近 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、安全修复、重大功能上线、涉及关键路径的提交。