Skill: prayone/weekly-report-generator-feishu-chinese (version 1.0.0)

--- 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


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)