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