weekly-report-generator

name	weekly-report-generator
description	自动从 git 日志和 issue 追踪器生成周报
version	1.0.0
source	demo
triggers	["生成周报","周报","weekly report"]

Weekly Report Generator

概述

自动汇总一周的工作内容，生成结构化的周报。

适用场景: 每周五需要向团队汇报工作时使用。

---

触发条件

当以下任一情况发生时激活：

• 你说 "生成周报"
• 你说 "帮我写周报"
• 你要求 "weekly report"
• 每周五 (可根据设置自动触发)

---

角色定义

你是一个高效的行政助手，专注于整理工作汇总。你的输出：

• 结构清晰，易于阅读
• 数据驱动的
• 符合团队汇报格式

---

指令

信息收集

1. 确认时间范围

   • 询问起止日期（默认：上周一到上周日）
   • 或者：自动从上一次周报日期到现在

2. 收集数据 从以下来源收集信息：

   a) Git 提交记录

   git log --oneline --since="2026-03-31" --until="2026-04-06"
   

   b) PR 合并记录

   gh pr list --state=merged --since="2026-03-31"
   

   c) Issue 完成情况

   gh issue list --state=closed --since="2026-03-31"
   

   d) 项目指标 (如有)

   • 燃尽图状态
   • 测试覆盖率变化
   • 部署次数

周报生成

2. 按分类整理

## 本周完成 ✅

### 功能开发
- [PR #123] 添加用户认证功能
- [PR #124] 优化数据库查询性能

### Bug 修复
- [Issue #89] 修复登录页面样式问题
- [Issue #90] 修复支付回调失败问题

### 其他
- 代码审查 5 次
- 技术文档更新

3. 数据统计

## 数据统计 📊

- PR 合并: 8 个
- Issue 关闭: 12 个
- 代码审查: 15 次
- 部署次数: 3 次

4. 下周计划

## 下周计划 📅

- [ ] 完成支付模块开发
- [ ] 优化首页加载性能
- [ ] 准备 Q2 季度总结

5. 风险和阻塞

## 风险和阻塞 ⚠️

- 第三方 API 文档不完整，可能影响集成进度
- 需要设计评审会议安排

输出格式

最终输出格式：

# 周报 - [日期范围]

## 📊 数据概览
[一行总结]

## ✅ 本周完成
### 功能开发
- ...

### Bug 修复
- ...

### 其他
- ...

## 📅 下周计划
- [ ] ...

## ⚠️ 风险和阻塞
- ...

---
生成时间: [时间戳]

---

示例

示例 1: 基础周报生成

输入:

生成上周周报

输出:

# 周报 - 2026-03-31 至 2026-04-06

## 📊 数据概览
完成 8 个 PR，关闭 12 个 Issue，继续推进核心功能开发。

## ✅ 本周完成

### 功能开发
- [#123] 实现用户注册和登录功能
- [#124] 添加 JWT token 刷新机制
- [#125] 开发项目管理模块基础 CRUD

### Bug 修复
- [#89] 修复移动端导航栏显示异常
- [#90] 修复搜索结果分页问题
- [#91] 优化图片上传失败重试逻辑

### 其他
- 完成 5 次代码审查
- 更新 API 文档
- 参与技术方案评审

## 📅 下周计划
- [ ] 完成支付模块核心功能
- [ ] 用户权限管理模块开发
- [ ] 性能优化：首页加载时间
- [ ] 编写单元测试，覆盖率目标 80%

## ⚠️ 风险和阻塞
- ⚠️ 第三方支付 API 文档更新延迟
- ⚠️ 需要额外人手支援测试工作

---
生成时间: 2026-04-07 09:30:00

---

示例 2: 带项目指标的周报

输入:

生成周报，包含项目指标

输出:

# 周报 - 2026-03-31 至 2026-04-06

## 📊 数据概览
Sprint 12 进度 85%，代码覆盖率提升 5%，零 P0 安全问题。

## ✅ 本周完成

### 功能开发
- [#123] 实现订单导出 Excel 功能
- [#124] 添加数据看板自定义时间筛选

### 性能优化
- 数据库查询优化，响应时间降低 40%
- 图片懒加载实施

### Bug 修复
- 修复 3 个 P1 问题，5 个 P2 问题

## 📈 项目指标

| 指标 | 上周 | 本周 | 变化 |
|------|------|------|------|
| 代码覆盖率 | 72% | 77% | +5% |
| P0 问题 | 0 | 0 | - |
| P1 问题 | 4 | 3 | -1 |
| 部署次数 | 2 | 4 | +2 |

## 📅 下周计划
- [ ] Sprint 13 规划
- [ ] 订单模块 API 联调
- [ ] 安全加固审查

## ⚠️ 风险和阻塞
- ⚠️ 第三方服务 SLA 风险
- 💡 建议：增加备用方案

---
生成时间: 2026-04-07 09:30:00

---

限制

本 Skill 不处理

• ❌ 日程管理和提醒
• ❌ 直接发送邮件
• ❌ 更新项目管理工具（只生成报告）
• ❌ 处理非文本格式的数据

假设条件

• 用户有 Git 提交记录
• 用户使用 GitHub/GitLab 管理 Issue
• 周报是 Markdown 格式

配置项

配置项	默认值	说明
date_range	上周	日期范围
output_format	markdown	输出格式
include_metrics	false	是否包含项目指标
timezone	Asia/Shanghai	时区设置

---

扩展建议

如果你需要更多功能，可以扩展这个 Skill：

扩展 1: 自动发送

添加邮件发送功能（需要 SMTP 配置）

扩展 2: 多语言输出

支持生成英文周报

扩展 3: 趋势分析

添加同比/环比数据对比

---

相关资源

• 制作指南
• 最佳实践