# Yy Create Report

> 生成面向管理人员的业务视角工作报告。当用户说"生成工作报告"、"写工作报告"、"汇总工作"、"生成工作总结"时触发。 不用于生成技术变更日志、面向开发者的提交记录摘要，也不用于生成项目交接文档或代码评审报告。

- Skill: `bulls-cows/yy-create-report` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add bulls-cows/yy-create-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bulls-cows/yy-create-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: bulls-cows (https://skillmd.com/u/bulls-cows)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bulls-cows/yy-create-report

---


# yy-create-report

## 描述

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

**核心特点**：

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

## 使用场景

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

不应触发：

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

## 指令

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

```bash
git config user.name
git config user.email
```

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

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

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

- `--author "张三"`
- `作者：张三`
- `账号：zhangsan@example.com`

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

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

### 步骤 3. 确定日期范围

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

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

### 步骤 4. 读取 Git 提交记录

```bash
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. 输出结构化工作报告

**决策分支**：

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

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

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

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

---

### 一、业务功能交付

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

### 二、流程优化提升

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

### 三、问题解决修复

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

### 四、环境配置管理

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

### 五、文档知识更新

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

### 六、其他工作事项

- 参与评审、会议等工作
```

## 输出示例

### 有提交记录

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

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

---

### 一、业务功能交付

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

### 二、流程优化提升

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

### 三、问题解决修复

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

### 四、环境配置管理

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

### 五、文档知识更新

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

### 六、其他工作事项

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

### 无提交记录

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

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

本周暂无提交记录。

可能原因：

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

## 注意事项

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

## 验收清单

执行技能后检查：

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