用 Claude Code 把每周研发周报自动化:一次真实的落地

每周五下午,我都要花一个多小时把这周的 git 提交、合并的 PR、几次评审会议记录整理成一份研发周报。重复、机械、又不能不做。这篇记录我怎么用 Claude Code 把它压缩到一条命令 + 两分钟核对,并且这套流程组里已经有三个人照着复现成功。

一、原来的流程,慢在哪

手工周报的耗时几乎全在"搜集"而不是"写作":翻 git log、翻 PR 列表、翻会议纪要,再人肉归类。真正动脑写结论的部分其实很短。

我掐表统计了连续四周的实际耗时:

所以自动化的目标很明确——把搜集和初稿交给模型,人只做最后的判断和润色。

二、核心:一条命令生成初稿

Claude Code 支持用 -p 传入任务、直接读取当前仓库上下文。最小可用的一条命令是这样:

# 汇总本周 git 历史与 PR,产出结构化周报草稿
claude -p "读取最近 7 天的 git log 与合并的 PR,
       按 [新功能 / 修复 / 重构 / 风险] 四类归纳,
       每条给一句人话说明,输出 Markdown" \
       --add-dir . --output report.md

关键不在命令本身,而在 prompt 里的归类框架:给定四个固定类别,输出的周报结构每周一致,方便对比,也避免模型自由发挥跑题。

第一版我没有给类别,让它"自由总结",结果是每周的小标题都不一样,四周下来根本没法纵向对比。加上固定四类之后,这个问题彻底消失。

让它读到会议记录

git 之外,会议纪要放在内部 wiki。我用一个 MCP server 把 wiki 只读接口暴露给 Claude,让它在生成周报时一并检索本周相关的会议结论:

{
  "mcpServers": {
    "wiki": {
      "command": "node",
      "args": ["./servers/wiki.js"],
      "env": { "WIKI_TOKEN": "$WIKI_RO_TOKEN" }
    }
  }
}

注意 token 走环境变量,别写进配置文件——这个配置是要提交到仓库给同事复用的。

三、踩过的三个坑

• 上下文过长被截断:提交多的一周会超窗口。解法是先用 git log --oneline 压缩,再让模型展开需要的条目。加 --since 限定范围比事后裁剪更稳。
• 敏感信息:PR 里偶有内部密钥片段。在 MCP 层做了正则脱敏,宁可误伤不可泄露。
• 幻觉归因:模型偶尔把 A 的改动写成 B 做的。所以最后必须人核对作者,这一步没法省。

第三个坑最值得说。我一开始以为把作者名写进 prompt 就够了,实际上当一次 PR 有多个 commit 作者时,模型倾向于只保留第一个。现在我的做法是让它在每条后面附上 commit hash,人核对时一眼就能查。

四、结果与成本

从约 70 分钟压到 约 8 分钟(其中 6 分钟是人核对)。按每周一次算,一个季度省下约 13 小时。API 成本每次约 ¥0.4,可忽略。

# 想复现的同事:克隆示例仓库后直接跑
git clone git@internal:praxis/weekly-report-demo.git
cd weekly-report-demo && ./weekly-report.sh
# 预期:根目录生成 report.md,含四个固定小标题

完整脚本、prompt 模板与脱敏正则见附件,欢迎照着复现后在评论里反馈你的结果。