---
slug: "weekly-report-ppt"
source_type: "skill_md"
source_url: "https://cdn.jsdelivr.net/gh/hacker4257/weekly-report-ppt@main/SKILL.md"
repo: "https://github.com/hacker4257/weekly-report-ppt"
source_file: "SKILL.md"
branch: "main"
---
# 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 <DAYS>
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）
- 按功能归类的文件清单（只在附录出现）

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