SuperAPI AI 工具集

git-weekly-report-cn

通用与其它

查看项目

更新于 10-16 06:52

技能介绍

用途:从 Git 提交日志生成结构化日报或周报,适合总结昨天/今天的 Git 活动、汇总一个或多个仓库的近期活动、回顾某时间段完成的工作、准备每日站会汇总。不适用于代码审查、查看单条提交详情、分支合并等日志以外的 Git 操作,以及与 Git 无关的报告。

主要能力:按日期范围、作者、仓库路径过滤提交;脚本输出 JSON,按仓库分组提供结构化提交数据(含 hash、short_hash、author、date、subject、body、refs,以及 date_range、author_filter、repositories、total_commits);再依据分类指南归类提交,按模板生成 Markdown 周报。单仓库提交超过 50 条时按类别汇总而非逐条列出,并保留 short_hash 便于追溯。

使用方式:先确定日期范围与报告类型——日报默认 --since 为昨天、--until 为今天;周报默认 --since 为本周一、--until 为今天;其他情况默认最近 7 天。作者默认全部,仓库默认当前工作目录,多项目时收集所有路径。运行:python3 scripts/git_weekly_report.py --since <YYYY-MM-DD> --until <YYYY-MM-DD> [--author <名称>] [--repo <路径1> <路径2> ...]。常用示例: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;python3 scripts/git_weekly_report.py --since 2026-04-21 --merges。随后读取 JSON,按 weekly-report-format.md 分类,按 weekly-report-template.md 生成最终周报。

限制:"下周计划"和"风险阻塞"无法从 Git 日志推导,需向用户确认补充;日报默认不含这些板块,除非用户要求。进行中工作可留意 WIP、TODO、临时方案、未合并功能分支等信号;重要事项可识别 breaking change、安全修复、重大功能上线、关键路径提交。其他功能、收费与平台信息暂未提供。