Standup Zh

standup-zh — Git 活动中文日报/周报生成

把一段时间内的 git 提交,收敛成中国团队能直接用的中文日报或周报。

何时触发

用户说"写日报 / 写周报 / 今天做了什么 / 站会摘要 / standup / 帮我整理本周进展"。

用法

第一步:采集 git 活动素材

# 日报(默认取 1 day ago 到现在,当前 git user.email)
bash <skill>/bin/collect-activity.sh

# 周报(传入 since 参数)
bash <skill>/bin/collect-activity.sh "1 week ago"

# 指定具体日期区间和作者
bash <skill>/bin/collect-activity.sh "2024-06-01" "alice@example.com"

输出四段:

• RANGE — 时间范围描述
• AUTHOR — 作者邮箱
• COMMITS — 该区间该作者的提交列表(含 hash、日期、subject)
• STATS — 汇总改动文件数与增删行数

第二步:Claude 生成日报或周报

根据提交素材,按下方模板生成对应粒度的报告:

• 日报:选"日报模板";
• 周报:选"周报模板"(按主题/模块归并,不是逐条列提交)。

日报模板

## 日报 — YYYY-MM-DD

### 今日完成
- <按功能/模块归并,用人话描述,不是堆 commit subject>

### 进展说明
- <如有值得说明的技术决策、阻塞、风险,这里列出>

### 明日计划
- <占位,若无法从提交推断则留空并注明"请补充">

> 数据来源:git 提交 <hash-range>(共 N 条提交,变动 M 个文件)

周报模板

## 周报 — YYYY-MM-DD ~ YYYY-MM-DD

### 本周进展

#### <主题/模块一>
- <同类提交归并成一两句;说明做了什么、为什么>

#### <主题/模块二>
- ...

### 主要数字
- 提交数:N 条 | 变动文件:M 个 | +X / -Y 行

### 下周计划
- <占位;若无法推断则留空并注明"请补充">

> 数据来源:git log --since="<since>" --author="<author>"

硬规则

• 基于真实提交:所有内容必须有对应提交佐证,不臆造。
• 提交信息不足时如实说:commit subject 语义不清时,描述"细节不足,仅知改动了 <文件/模块>",不要编造动机。
• 面向人而非堆 commit:同类提交归并,去掉内部噪音(如 chore: 改 typo、wip 等可省略或简短带过)。
• 产出中文:报告全文中文;代码标识符、API 名、库名、commit hash 保留英文。
• 明日计划/下周计划:无法从提交推断时,明确标注"请补充",不要凭空填写。

边界

• 只读 git,不写任何文件,不推送。
• 默认只看当前仓库;多仓库场景需切目录多次运行再汇总。
• 时间范围由 git 解析(--since);跨时区时注意本地 git 时区配置。