周报生成器 Skill

当用户需要生成周报、总结本周工作、或分析 git 提交记录时，必须先调用此 skill。
此 skill 定义了如何从 git log 提取信息、分类工作内容、格式化周报的完整流程。

一、核心功能

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

主要特性：

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

---

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

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

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

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

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

1. 2. 该脚本会自动：

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

1. 3. 提取关键数据：

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

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

如果用户发送了截图：

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

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

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

1. 1. 合并重复内容

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

1. 2. 业务化表达

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

1. 3. 分类归纳

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

1. 4. 突出亮点

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

步骤 4：生成周报内容

重要：

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

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

markdown

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

本周工作内容

一、功能开发

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

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

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

三、其他工作（如果有）

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

工作数据

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

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

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

---

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

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

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

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

markdown

一、功能开发

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

二、自动化与工具建设

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

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

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

1. 1. 直接执行发送命令：

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

1. 2. 显示发送结果：

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

说明：

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

---

三、Git 命令参考

获取基础提交日志

bash

获取本周提交（周一到今天）

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

获取代码统计

bash

获取代码增删量

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

多仓库统计

bash

遍历多个仓库目录

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. 自定义分类规则

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

用户可以提供自己的关键词映射：

• - 实现 → 新功能
• 完成 →