yy-create-report

yy-create-report

描述

本技能自动读取指定时间范围内指定或默认 Git 账号的提交记录，以业务视角分类归纳，生成面向没有技术背景的管理人员阅读的简洁易懂的结构化工作报告。支持通过参数指定任意账号，未指定时默认使用当前电脑配置的 Git 账号。

核心特点：

• 用业务语言描述技术工作，避免技术术语
• 突出工作价值和业务影响
• 结构清晰，便于快速阅读和理解

使用场景

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

不应触发：

• 用户只是查询 Git 提交记录，未提及报告
• 用户要求直接执行 git log
• 用户要求提交代码

指令

步骤 1. 获取当前 Git 账号信息

git config user.name
git config user.email

如果未配置 Git 用户信息，提示用户先配置。

步骤 2. 解析指定账号参数

检查用户输入中是否包含指定账号的信息，支持以下格式：

• --author "张三"
• 作者：张三
• 账号：[email protected]

如果用户未指定，则使用步骤 1 获取的 git config user.name 作为默认账号。

最终确定的账号值将用于步骤 4 的 --author 参数。

步骤 3. 确定日期范围

• 本周：从本周一到今天
• 上周：从上周一到上周日
• 自定义：按用户指定的日期范围

用户未指定时，默认查询本周（从本周一到今天）。

步骤 4. 读取 Git 提交记录

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

参数说明：

• --since：开始日期
• --until：结束日期
• --author：只统计指定作者的提交（来源：步骤 2 确定的账号，默认为当前 Git 账号）
• --no-merges：排除合并提交

步骤 5. 分类归纳

决策分支：

根据提交信息关键词分类，使用业务导向的分类名称：

• 业务功能交付：feat, 新增, 添加, feature - 描述为"完成XX功能开发"、"上线XX功能"等
• 流程优化提升：refactor, 优化, 调整, improve - 描述为"优化XX流程"、"提升XX效率"等
• 问题解决修复：fix, 修复, bug, hotfix, 解决 - 描述为"解决XX问题"、"修复XX缺陷"等
• 环境配置管理：config, chore, 依赖, build - 描述为"更新系统配置"、"升级依赖版本"等
• 文档知识更新：docs, 文档, readme - 描述为"完善XX文档"、"更新知识文档"等
• 其他工作事项：无法归类的提交 - 描述为"参与XX评审"、"协助XX工作"等

处理规则：

• 合并相似的提交内容
• 使用中文输出，避免技术术语
• 每个条目突出业务价值和影响

步骤 6. 输出结构化工作报告

决策分支：

• 有提交记录：按业务分类输出完整报告
• 无提交记录：输出友好提示信息，说明可能原因

按以下格式输出，使用业务语言便于管理人员理解：

## 工作报告（日期范围）

**工作摘要：** 用简短的业务语言描述核心工作内容和价值

---

### 一、业务功能交付

1. **功能名称** - 说明该功能带来的业务价值和影响
2. **功能名称** - 说明该功能带来的业务价值和影响

### 二、流程优化提升

1. **优化事项** - 说明优化带来的效率提升或成本节约
2. **优化事项** - 说明优化带来的效率提升或成本节约

### 三、问题解决修复

1. **问题描述** - 说明问题影响范围及解决后的改善效果
2. **问题描述** - 说明问题影响范围及解决后的改善效果

### 四、环境配置管理

- 配置更新事项
- 依赖升级事项

### 五、文档知识更新

- 文档完善内容
- 知识沉淀事项

### 六、其他工作事项

- 参与评审、会议等工作

输出示例

有提交记录

## 本周工作报告（2024-01-15 ~ 2024-01-19）

**工作摘要：** 完成用户登录、个人中心及消息通知功能开发，优化系统性能，提升用户体验

---

### 一、业务功能交付

1. **用户登录功能** - 实现安全可靠的用户身份验证，保障账号安全
2. **个人中心页面** - 支持用户编辑个人资料和上传头像，提升用户体验
3. **消息通知系统** - 实现实时消息推送，让用户及时获取重要信息

### 二、流程优化提升

1. 优化系统请求处理流程，减少重复操作，提升响应速度
2. 优化系统状态管理机制，提升整体运行效率

### 三、问题解决修复

1. 解决移动端输入时界面显示异常问题，提升移动端用户体验
2. 修复深色模式下部分内容显示问题，确保界面一致性

### 四、环境配置管理

- 更新系统依赖组件版本，提升系统稳定性和安全性
- 配置自动化部署流程，提高交付效率

### 五、文档知识更新

- 完善系统接口说明文档，便于团队协作和知识传承

### 六、其他工作事项

- 参与代码评审 3 次，保障代码质量

无提交记录

## 本周工作报告（2024-01-15 ~ 2024-01-19）

**工作摘要：** 暂无提交记录

本周暂无提交记录。

可能原因：

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

注意事项

• 使用正斜杠作为路径分隔符，路径包含空格时使用引号包裹
• 如果指定时间范围无提交，提示用户"暂无提交记录"
• 保持格式整洁美观
• 如果项目不在 git 仓库中，提示用户
• 默认统计当前 Git 账号的提交记录，可通过参数指定其他账号（支持用户名或邮箱）
• 输出后询问用户是否需要调整格式或补充内容

验收清单

执行技能后检查：

1. 报告标题包含正确的日期范围
2. 分类归纳准确（功能开发、代码优化、问题修复等）
3. 提交内容已合并相似项，无重复
4. MR 建议标题简洁概括核心工作
5. 使用中文输出，格式整洁美观