yy-create-report

Installation
SKILL.md

yy-create-report

概述

本技能自动读取指定时间范围内当前 Git 账号的提交记录,按类型分类归纳,生成结构化工作报告。

使用场景

  • 用户说"生成工作报告"
  • 用户说"写工作报告"
  • 用户说"汇总工作"
  • 用户说"生成工作总结"
  • 用户要求"生成本周工作报告"
  • 用户要求"生成上周工作报告"
  • 用户要求"生成指定日期范围的工作报告"

操作步骤

1. 获取当前 Git 账号信息

首先获取当前 Git 配置的用户信息:

git config user.name
git config user.email

注意:

  • 如果未配置 Git 用户信息,提示用户先配置
  • 使用获取到的用户名作为 --author 参数的值

2. 确定日期范围

根据用户需求确定 git log 的日期范围:

类型 命令参数
本周 从本周一到今天
上周 从上周一到上周日
自定义 按用户指定的日期范围

如果用户未指定日期范围,默认查询本周(从本周一到今天)。

3. 读取 Git 提交记录

在项目目录下执行 git 命令获取指定日期范围内当前用户的提交:

git log --since="YYYY-MM-DD" --until="YYYY-MM-DD" --author="用户名" --pretty=format:"%h | %ad | %s" --date=short --no-merges

参数说明:

  • --since:开始日期
  • --until:结束日期
  • --author:只统计指定作者的提交(使用步骤 1 获取的用户名)
  • --pretty=format:输出格式
  • --no-merges:排除合并提交

4. 分类归纳

分析提交信息,按以下类别归纳:

分类 关键词
功能开发 feat, 新增, 添加, feature
代码优化 refactor, 优化, 调整, improve
问题修复 fix, 修复, bug, hotfix, 解决
配置相关 config, chore, 依赖, build
文档更新 docs, 文档, readme

注意:

  • 如果提交信息不明确,归类为"其他"
  • 合并相似的提交内容
  • 使用中文输出

5. 输出结构化工作报告

按以下格式输出:

## 工作报告标题(日期范围)

### 一、功能开发
1. 功能点1
2. 功能点2

### 二、代码优化
1. 优化项1
2. 优化项2

### 三、问题修复
1. 修复项1

### 四、配置相关
- 配置项1

### 五、文档更新
- 文档项1

### 六、其他
- 其他工作

Output contract

必需输出字段

字段 类型 说明
工作报告标题 string 包含日期范围
MR建议标题 string 用简短的话描述核心工作内容,适合作为提交MR时的标题
功能开发 array 功能开发类提交列表
代码优化 array 代码优化类提交列表
问题修复 array 问题修复类提交列表
配置相关 array 配置相关提交列表
文档更新 array 文档更新类提交列表
其他 array 其他类提交列表

输出格式

完整工作报告

## 本周工作报告(2024-01-15 ~ 2024-01-19)

**MR建议标题:** 实现用户登录、个人中心及消息通知功能

### 一、功能开发
1. **用户登录功能** - 实现基于 JWT 的用户认证,支持 Token 刷新
2. **个人中心页面** - 新增用户资料编辑、头像上传功能
3. **消息通知系统** - 实现 WebSocket 实时消息推送

### 二、代码优化
1. 优化 API 请求拦截器,减少重复代码
2. 重构状态管理模块,提升性能
3. 优化图片加载策略,缩短首屏渲染时间

### 三、问题修复
1. 修复 iOS 软键盘弹起时布局错位问题
2. 修复深色模式下部分组件显示异常
3. 修复表单提交后数据未及时刷新的问题

### 四、配置相关
- 更新依赖包版本(vue@3.4、vite@5.0)
- 添加 ESLint 规料配置
- 配置 CI/CD 自动化流程

### 五、文档更新
- 更新 API 接口文档
- 补充组件使用说明

### 六、其他
- 参与代码评审 3 次
- 技术分享会议 1 次

无提交记录

## 本周工作报告(2024-01-15 ~ 2024-01-19)

**MR建议标题:** 无提交记录

本周暂无提交记录。

可能原因:
- 尚未开始新任务
- 工作内容为会议/文档相关
- 变更尚未提交
- 提交作者与当前 Git 账号不匹配

分类规则

分类 关键词 说明
功能开发 feat, 新增, 添加, feature 新功能实现
代码优化 refactor, 优化, 调整, improve 重构和性能优化
问题修复 fix, 修复, bug, hotfix, 解决 Bug 修复
配置相关 config, chore, 依赖, build 构建和配置变更
文档更新 docs, 文档, readme 文档相关
其他 其他 无法归类的提交

注意事项

  • 使用正斜杠作为路径分隔符,路径包含空格时使用引号包裹,以确保跨平台兼容性和正确解析
  • 如果本周无提交,提示用户"本周暂无提交记录"
  • 保持格式整洁美观
  • 如果项目不在 git 仓库中,提示用户
  • 只统计当前 Git 账号的提交记录(通过 --author 参数过滤)
  • 输出后询问用户是否需要调整格式或补充内容
Related skills
Installs
15
First Seen
Apr 20, 2026