- name
- weekly-report-generator
- description
- |
周报生成器 Skill
<HARD-GATE> 当用户需要生成周报、总结本周工作、或分析 git 提交记录时，必须先调用此 skill。 此 skill 定义了如何从 git log 提取信息、分类工作内容、格式化周报的完整流程。 </HARD-GATE>
一、核心功能
自动从 git 提交记录中提取工作内容，生成结构化的周报文档。
主要特性：
- 📊 自动读取指定时间范围的 git 提交记录
- 🏷️ 智能分类工作内容（新功能、Bug 修复、优化、文档等）
- 📝 生成格式化的周报 Markdown 文档
- 🔍 支持多项目、多分支统计
- ⚙️ 可自定义时间范围、格式模板
二、工作流程（标准流程 - 必须严格遵守）
步骤 1：自动整理 Git 提交记录
无需询问用户，直接执行以下操作：
- 使用自动周报脚本来源资料：
/Users/ai/cline-skills/auto-weekly-report.sh- 该脚本会自动：
- 扫描 PROJECT_ROOT 环境变量指定的目录（或脚本中配置的默认路径）下所有 Git 仓库 - 统计本周一到今天的所有提交记录 - 统计代码变更量（增加/删除行数） - 提取提交信息用于生成工作内容 - 首次使用需要配置：编辑脚本设置 PROJECT_ROOT 变量为你的项目目录路径
- 提取关键数据：
- 提交次数 - 代码变更：+XXX -XXX 行 - 提交消息列表 - 统计仓库数量
步骤 2：识别截图（如果用户提供）
如果用户发送了截图：
- 使用视觉识别提取截图中的文字内容
- 识别工作事项、会议记录、问题处理等信息
- 将识别到的内容整理为结构化列表
步骤 3：AI 智能整合和优化
核心工作：将 Git 记录 + 截图内容整合优化
- 合并重复内容
- 识别并合并相同或相似的工作项 - 例如：多次提交同一个功能，合并为一条
- 业务化表达
- 将技术性的 commit 信息转换为业务语言 - 例如："SXGH-1183 新增封面" → "搭建霍兰德测评核心框架，完成报告封面页面设计与实现"
- 分类归纳
- 功能开发（来自 Git 提交） - 自动化与工具建设（来自 Git 或截图） - 会议与协作（来自截图） - 问题处理（来自截图）
- 突出亮点
- 识别本周特别的工作成果 - 添加"工作亮点"部分
步骤 4：生成周报内容
重要：
- 周报文件统一保存在
/Users/ai/cline-skills/目录下 - 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, 3, 4, 5...
- 标点规范：每条以分号（；）结尾，最后一条以句号（。）结尾
- 业务语言：使用业务功能描述，不要直接复制 Git 提交信息
- 合并相关：将多个相关的 git 提交合并为一条业务描述
- 突出价值：强调完成的功能价值和用户体验
格式示例（参考本周实际周报）：
### 一、功能开发
1. 搭建霍兰德测评核心框架，完成报告封面页面设计与实现；
2. 开发MBTI性格测评模块，实现测评界面与交互逻辑；
3. 优化筛选功能，新增重置按钮提升用户体验。
### 二、自动化与工具建设
4. 完成周报自动化系统配置，实现手动生成周报自动发送到飞书功能；
5. 开发定时任务脚本，配置每周四上午9:52自动生成并发送周报；
6. 创建macOS launchd定时任务配置，实现周报自动化流程；
7. 编写完整的配置说明文档，包含使用方式、故障排查和管理命令。步骤 5：自动发送到飞书（必须执行）
重要：AI优化完周报后必须立即发送到飞书，无需任何检查或询问。
- 直接执行发送命令：
/Users/ai/cline-skills/send-to-feishu.sh /Users/ai/cline-skills/weekly-report-YYYYMMDD.md- 显示发送结果：
- ✅ 成功：告知用户"周报已生成并自动发送到飞书！" - ❌ 失败：显示错误信息
说明：
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：
- ✅ 用户说"生成周报"、"写周报"、"总结本周工作"
- ✅ 用户询问"这周做了什么"、"统计提交记录"
- ✅ 用户需要汇报工作进展
- ✅ 用户要查看 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