standup-zhlisted

# standup-zh — Git 活动中文日报/周报生成 把一段时间内的 git 提交,收敛成中国团队能直接用的中文日报或周报。 ## 何时触发 用户说"写日报 / 写周报 / 今天做了什么 / 站会摘要 / standup / 帮我整理本周进展"。 ## 用法 ### 第一步:采集 git 活动素材 ```bash # 日报(默认取 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 生成日报或周报 根据提交素材,按下方模板生成对应粒度的报告: - **日报**:选"日报模板"; - **周报**:选"周报模板"(按主题/模块归并,不是逐条列提交)。 --- ## 日报模板 ```markdown ## 日报 — YYYY-MM-DD ### 今日完成 - <按功能/模块归并,用人话描述,不是堆 commit subject> ### 进展说明 - <如有值得说明的技术决策、阻塞、风险,这里列出> ### 明日计划 - <占位,若无法从提交推断则留空并注明"请补充"> > 数据来源:git 提交 <hash-range>(共 N 条提交,变动 M 个文件) ``` --- ## 周报模板 ```markdown ## 周报 — 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 时区配置。