weekly-report-generator-feishu-chinese

SKILL.md

---
name: weekly-report-generator
description: "Use this skill to generate weekly reports from git commit logs. Automatically analyzes git history, categorizes work, and formats a professional weekly report."
---

# 周报生成器 Skill

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

## 一、核心功能

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

### 主要特性：

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

---

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

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

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

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

   ```bash
   /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统一发送到飞书

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

```markdown
# 周报 - 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. **突出价值**：强调完成的功能价值和用户体验

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

```markdown
### 一、功能开发

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

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

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

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

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

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

   ```bash
   /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 命令参考

### 获取基础提交日志

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

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

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

### 3. 团队周报

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

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

### 4. 周报模板自定义

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

---

## 五、使用此 Skill 的时机

在以下情况下调用此 skill：

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

---

## 六、注意事项

### Git 配置检查

在执行前检查：

```bash
# 确认 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