周报生成器 Skill

一、核心功能

自动从 git 提交记录中提取工作内容，生成结构化的周报文档。

主要特性：

• 📊 自动读取指定时间范围的 git 提交记录
• 🏷️ 智能分类工作内容（新功能、Bug 修复、优化、文档等）
• 📝 生成格式化的周报 Markdown 文档
• 🔍 支持多项目、多分支统计
• ⚙️ 可自定义时间范围、格式模板

二、工作流程（标准流程 - 必须严格遵守）

步骤 1：自动采集 Git 提交记录

无需询问用户，直接执行以下操作：

1. 使用自动周报脚本采集数据：

   /Users/ai/cline-skills/auto-weekly-report.sh
   

2. 该脚本会自动：

   • 扫描 PROJECT_ROOT 环境变量指定的目录（或脚本中配置的默认路径）下所有 Git 仓库
   • 统计本周一到今天的所有提交记录
   • 统计代码变更量（增加/删除行数）
   • 提取提交信息用于生成工作内容
   • 首次使用需要配置：编辑脚本设置 PROJECT_ROOT 变量为你的项目目录路径

3. 提取关键数据：

   • 提交次数
   • 代码变更：+XXX -XXX 行
   • 提交消息列表
   • 统计仓库数量

步骤 2：识别截图（如果用户提供）

如果用户发送了截图：

1. 使用视觉识别提取截图中的文字内容
2. 识别工作事项、会议记录、问题处理等信息
3. 将识别到的内容整理为结构化列表

步骤 3：AI 智能整合和优化

核心工作：将 Git 记录 + 截图内容整合优化

1. 合并重复内容

   • 识别并合并相同或相似的工作项
   • 例如：多次提交同一个功能，合并为一条

2. 业务化表达

   • 将技术性的 commit 信息转换为业务语言
   • 例如："SXGH-1183 新增封面" → "搭建霍兰德测评核心框架，完成报告封面页面设计与实现"

3. 分类归纳

   • 功能开发（来自 Git 提交）
   • 自动化与工具建设（来自 Git 或截图）
   • 会议与协作（来自截图）
   • 问题处理（来自截图）

4. 突出亮点

   • 识别本周特别的工作成果
   • 添加"工作亮点"部分

步骤 4：生成周报内容

重要：

1. 周报文件统一保存在 /Users/ai/cline-skills/ 目录下
2. AI优化后的周报将在步骤5统一发送到飞书

按照以下标准模板格式化周报：

# 周报 - YYYY-MM-DD 至 YYYY-MM-DD

## 本周工作内容

### 一、功能开发

1. [业务功能描述]，[具体实现内容]；
2. [业务功能描述]，[具体实现内容]；
3. [业务功能描述]，[具体实现内容]。

### 二、自动化与工具建设（如果有）

4. [工具或自动化描述]，[具体完成内容]；
5. [工具或自动化描述]，[具体完成内容]。

### 三、其他工作（如果有）

6. [会议/协作/问题处理等]

## 工作数据

- 代码提交：X 次
- 代码变更：+XXX -XXX 行
- 统计仓库：54 个
- 工作天数：X 天
- 自动化工具：[如果有新工具，列出来]

## 工作亮点（如果本周有特别成果）

✨ [总结本周特别的亮点工作，例如完成了重要功能、搭建了新系统等]

---

**统计时间**：YYYY-MM-DD HH:MM
**统计用户**：wangping
**生成工具**：Weekly Report Generator (AI优化版)

周报格式要求（必须严格遵守）：

1. 分类清晰：按"功能开发"、"自动化工具"、"其他工作"分类
2. 数字连续：全文统一编号 1, 2, 3, 4, 5...
3. 标点规范：每条以分号（；）结尾，最后一条以句号（。）结尾
4. 业务语言：使用业务功能描述，不要直接复制 Git 提交信息
5. 合并相关：将多个相关的 git 提交合并为一条业务描述
6. 突出价值：强调完成的功能价值和用户体验

格式示例（参考本周实际周报）：

### 一、功能开发

1. 搭建霍兰德测评核心框架，完成报告封面页面设计与实现；
2. 开发MBTI性格测评模块，实现测评界面与交互逻辑；
3. 优化筛选功能，新增重置按钮提升用户体验。

### 二、自动化与工具建设

4. 完成周报自动化系统配置，实现手动生成周报自动发送到飞书功能；
5. 开发定时任务脚本，配置每周四上午9:52自动生成并发送周报；
6. 创建macOS launchd定时任务配置，实现周报自动化流程；
7. 编写完整的配置说明文档，包含使用方式、故障排查和管理命令。

步骤 5：自动发送到飞书（必须执行）

重要：AI优化完周报后必须立即发送到飞书，无需任何检查或询问。

1. 直接执行发送命令：

   /Users/ai/cline-skills/send-to-feishu.sh /Users/ai/cline-skills/weekly-report-YYYYMMDD.md
   

2. 显示发送结果：

   • ✅ 成功：告知用户"周报已生成并自动发送到飞书！"
   • ❌ 失败：显示错误信息

说明：

• auto-weekly-report.sh 脚本只负责采集数据和生成初始周报，不会自动发送
• AI 优化周报内容后，统一调用 send-to-feishu.sh 发送一次
• 避免重复发送周报到飞书

三、Git 命令参考

获取基础提交日志

# 获取本周提交（周一到今天）
git log --since="$(date -v-Mon +%Y-%m-%d)" --author="$(git config user.name)" --format="%H|%an|%ad|%s" --date=short

# 获取上周提交
git log --since="$(date -v-Mon -v-7d +%Y-%m-%d)" --until="$(date -v-Sun -v-7d +%Y-%m-%d)" --format="%H|%an|%ad|%s" --date=short

# 获取指定日期范围
git log --since="2026-03-18" --until="2026-03-24" --format="%H|%an|%ad|%s" --date=short

获取代码统计

# 获取代码增删量
git log --since="2026-03-18" --until="2026-03-24" --author="$(git config user.name)" --pretty=tformat: --numstat | awk '{add+=$1; del+=$2} END {print "+"add" -"del}'

# 获取提交次数
git log --since="2026-03-18" --until="2026-03-24" --author="$(git config user.name)" --oneline | wc -l

# 获取活跃天数
git log --since="2026-03-18" --until="2026-03-24" --author="$(git config user.name)" --format="%ad" --date=short | sort -u | wc -l

多仓库统计

# 遍历多个仓库目录
for repo in /path/to/repo1 /path/to/repo2; do
  echo "=== $repo ==="
  cd "$repo"
  git log --since="2026-03-18" --until="2026-03-24" --format="%H|%an|%ad|%s" --date=short
done

四、高级功能

1. 多项目聚合

如果用户在多个项目中工作，支持聚合统计：

• 询问用户需要统计的所有项目路径
• 分别读取每个项目的 git log
• 按项目分组展示
• 生成总体统计数据

2. 自定义分类规则

允许用户自定义提交信息的分类规则：

用户可以提供自己的关键词映射：
- "实现" → 新功能
- "完成" → 新功能
- "调整" → 优化

3. 团队周报

支持生成团队整体周报（所有成员的提交汇总）：

• 按成员分组统计
• 生成团队贡献图表
• 对比各成员工作量

4. 周报模板自定义

用户可以提供自己的周报模板文件，skill 会按模板格式填充数据。

五、使用此 Skill 的时机

在以下情况下调用此 skill：

1. ✅ 用户说"生成周报"、"写周报"、"总结本周工作"
2. ✅ 用户询问"这周做了什么"、"统计提交记录"
3. ✅ 用户需要汇报工作进展
4. ✅ 用户要查看 git 提交历史并格式化

六、注意事项

Git 配置检查

在执行前检查：

# 确认 git 用户配置
git config user.name
git config user.email

# 确认当前仓库状态
git status

# 确认是否在 git 仓库中
git rev-parse --git-dir

时区处理

• 使用本地时区处理日期
• 周一定义：按照本地日历周一
• 日期范围：包含起始日期，包含结束日期

提交信息编码

• 处理中文提交信息
• 处理特殊字符（如 |、换行符）
• 确保输出 UTF-8 编码

错误处理

• 如果不在 git 仓库中，提示用户
• 如果指定日期范围无提交，说明情况
• 如果 git 命令失败，显示详细错误信息

七、关键原则

• User-centric - 先询问用户需求，确认参数后再执行
• Accurate parsing - 准确解析 git log 输出，避免数据错误
• Smart categorization - 智能分类提交，但允许用户调整
• Clear formatting - 生成清晰、结构化的周报文档
• Flexible output - 支持多种输出格式和自定义模板

八、示例对话流程

用户：帮我生成本周的周报

AI：好的，我将使用 weekly-report-generator skill 为你生成周报。
    首先确认几个参数：

    1. 时间范围：本周（2026-03-23 周一 到今天 2026-03-24 周二）
    2. Git 仓库：当前目录 /Users/project/zhdf
    3. 分支：当前分支 main
    4. 提交者：当前用户 (你的用户名)
    5. 输出格式：Markdown

    请确认是否正确？

用户：确认

AI：[执行 git log 命令，分析提交记录，生成周报]

    周报已生成！保存在：weekly-report-20260325.md

    本周概览：
    - 提交次数：15 次
    - 代码变更：+523 -187 行
    - 工作天数：2 天

    主要工作分类：
    🚀 新功能：5 个
    🐛 Bug修复：3 个
    ⚡️ 性能优化：2 个

    需要我展示详细内容吗？

创建时间：2026-03-25 版本：1.0 作者：AI Assistant