git-weekly-report-cnlisted
Install: claude install-skill YangsonHung/awesome-agent-skills
# 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 --merge