Skill: 程序员周报 & PPT（含代码扫描）

目的

根据代码仓库的实际变更（git log / changed files / diffstat），自动生成：

1. 领导可读的文字周报
2. 可直接做 PPT 的页级大纲 并尽量按“功能/模块”而非“文件/类名”描述产出。

何时使用

• 用户说“生成周报/迭代汇报/本周总结”
• 用户提到“扫一下代码/根据提交/根据 diff 生成汇报”
• 或用户直接用 /weekly-report-ppt 调用

执行步骤（必须遵循）

1. 先确定时间范围：默认最近 7 天；若用户指定天数则使用用户值。
2. 运行扫描脚本收集事实：
   • bash weekly-report-ppt/scripts/scan_repo.sh
3. 从扫描输出中提取 “Changed files” 列表，并做功能归类：
   • 将 changed files 通过管道传给 python3 weekly-report-ppt/scripts/summarize_changes.py
   • 得到 JSON：{功能: [文件...], ...}
4. 基于提交摘要 + 功能归类 + 变更规模（diffstat），生成“按功能描述”的工作项。 注意：不要把文件名堆给管理者；文件名只在“技术附录（可选）”里出现。

输出要求

第一部分：文字版周报

结构（无内容则省略）： 一、本周工作完成情况（按功能归类，每条写清“做了什么 + 价值/影响”） 二、存在的问题与风险（没有依据就不要编；可提示用户补充） 三、下周工作计划（用户没给就写“待补充”，不要编造）

规则：

• 不夸大；未完成必须标明“进行中/待验证/待上线”
• 描述面向结果：稳定性/性能/可维护性/交付风险/业务支持
• 避免堆技术术语；必要术语放到技术附录

第二部分：PPT 汇报大纲

页级输出（每页 2-4 条要点）： P1 汇报范围与结论（周期、涉及系统、总体进展） P2 本周核心成果（Top 3-5，按功能） P3 关键技术工作（重构/性能/稳定性/架构） P4 风险与阻塞（影响 + 对策 + 需要支持） P5 下周计划与目标（尽量可量化）

可选：技术附录（给技术同事看）

• 本周提交摘要（top N）
• 按功能归类的文件清单（只在附录出现）

安全边界

• 只读扫描，不做任何写操作（不修改文件、不提交、不推送、不切分支）
• 不基于猜测编造“完成了某功能”