Git Weekly Report

概览

使用这个 skill 将本地 git 提交记录整理成中文周报条目。内置脚本会自动发现指定目录下的 git 仓库，优先从仓库 README 头部识别项目中文名，按时间范围和可选提交人筛选 commit，聚合相近事项，并按默认 5 天工作周分配耗时。

触发关键词

中文语境下，下面这些说法都应该触发本 skill：

• 生成周报
• 根据 git 提交生成周报
• 扫描这个目录下所有仓库的 commit
• 统计某人最近一周提交
• 按提交人汇总工作内容
• 分析最近一周 commit 并估算耗时
• 把 git 记录整理成周报

也支持英文表达，例如 git weekly report、summarize commits、weekly status from git history。

快速使用

先运行脚本，再按需要轻微润色条目：

python3 /Users/mr.yun/.codex/skills/git-weekly-report/scripts/git_weekly_report.py /path/to/repos --author "Author Name"

常用参数：

python3 /Users/mr.yun/.codex/skills/git-weekly-report/scripts/git_weekly_report.py /path/to/repos \
  --author "Author Name" \
  --since "2026-05-22" \
  --until "2026-05-29" \
  --workdays 5 \
  --include-evidence

如果省略 --since，默认取最近 7 天。如果省略 --author，默认包含所有提交人。

工作流程

1. 确认或推断扫描目录、提交人和时间范围。未指定时，默认最近 7 天、总工时 5 天。
2. 执行 scripts/git_weekly_report.py 获取初稿。
3. 检查脚本生成的条目和 evidence。若 commit message 太零散或太字面化，可人工合并、拆分或改写事项。
4. 默认只返回简洁周报；只有用户要求时才附带 commit 证据。

周报规则

• 每个事项写成一句简洁中文，末尾附上耗时，例如 0.5d、1d、2d。
• 最小耗时单位为 0.5d。
• 各事项耗时合计必须等于 --workdays，默认 5d。
• 平台名称优先读取仓库 README.md、readme.md、README.MD 或 README 前 80 行中带中文的标题；读取不到时使用仓库名称。
• commit message 中能看出更具体的平台、产品或模块名称时，人工润色可优先采用更具体的名称。
• 如果同一平台下有多个 0.5d 的简单零散事项，可以合并成一条；每条最多合并 3 个事项，不同事项之间用中文逗号分隔，并把耗时相加。
• 忽略低价值细节，例如拼写、格式化、依赖锁文件噪音、普通 merge commit；除非这些就是本周主要工作。
• 表述要偏结果导向：说明完成了什么能力、模块、优化、集成或修复。

耗时估算口径

以脚本分配结果为基准。人工调整时遵循：

• 横跨多天、commit 数较多、涉及多个相关模块的事项，分配更高耗时。
• 单个小修复通常为 0.5d。
• 多个同平台小修复或小优化可以合并为 1d、1.5d 等更自然的周报条目，但单条不要超过 3 个事项。
• 尽量按时间和事项上下文聚合，让周报读起来像真实工作流。
• 如果人工编辑后总耗时不等于 5 天，优先调整最大或最模糊的事项。

输出格式

1. 新版配置表平台检查结果白名单优化 0.5d
2. 新版配置表平台新增构建流水线模块 2d
3. aiCodingReview 平台项目管理、分支管理样式及交互优化 1d
4. aiCodingReview 平台新增获取SSO权限策略，动态显示配置管理 0.5d
5. 仓库名 修复发布流程异常并补充兼容处理 1d