---
name: work-report
description: 生成周报、月报、季度报和年终总结。当用户提到"周报"、"月报"、"季报"、"季度报"、"年终总结"、"年度总结"、"weekly report"、"monthly report"、"quarterly report"、"annual summary"、"yearly review"，或者需要生成各类工作报告时使用此 Skill。
allowed-tools: Read, Bash, Write, Glob, Grep, AskUserQuestion
---

# 工作报告生成器

生成周报、月报、季度报和年终总结。

## 报告类型

| 类型 | 时间范围 | 输入来源 | 主要内容 | 格式要求 |
|------|---------|---------|---------|---------|
| 周报 | 本周 | 每日工作记录/口述列点 | 本周工作、下周计划 | 固定格式，见模板 |
| 月报 | 当月 4-5 周 | 周报汇总 | 主要工作汇总、进度跟踪 | 灵活，突出重点工作和进度 |
| 季报 | 当季 12-13 周 | 周报汇总 | 季度工作总结、阶段性成果 | 灵活，突出重点工作和进度 |
| 年终总结 | 全年 52 周 | 周报汇总 | 业绩达成、个人成长、成长计划 | 固定格式，见模板 |

## 使用流程

### 第一步：确定报告类型和时间范围

首先确认用户需要生成的报告类型：

- **周报**：指定周（如本周、2025.01.06 - 2025.01.10）
- **月报**：指定月份（如 2025 年 12 月）
- **季报**：指定季度（如 2025 年 Q4）
- **年终总结**：指定年份（如 2025 年）

### 第二步：收集必要信息

在开始之前，需要向用户确认以下信息：

1. **周报文件路径**：包含周报的文件（支持 .rtf、.docx、.md、.txt 格式）
2. **规划文档路径**（可选，年终总结推荐提供）：年度工作规划文档
3. **补充信息**（可选）：对于事项的罗列和规划完成进展
4. **参考格式**（可选）：报告的格式模板或参考图片
5. **角色信息**（年终总结必填）：
   - 当前岗位
   - 期间是否有角色变化（如从项目经理转为架构师）
   - 角色变化的时间节点
6. **用户指引**（重要）：
   - 重点工作范围：用户希望重点突出哪些工作
   - 需要弱化或忽略的内容
   - 周报中可能存在的偏差或需要修正的地方
   - 其他特殊要求

### 第三步：读取并解析文件

使用以下方式读取 `rtf` 文件：

```bash
textutil -stdout -convert txt "文件路径.rtf"
```

对于 .md 或 .txt 文件，直接使用 Read 工具读取。

### 第四步：分析周报内容

1. **按时间线梳理**：将周报按时间顺序整理，筛选指定时间范围内的周报
2. **按角色分段**：如有角色变化，区分不同阶段的工作内容
3. **提取关键工作**：
   - 重点项目和版本
   - 技术方案和架构工作
   - 团队管理工作（如适用）
   - 跨团队协作
   - 问题处理和优化
4. **识别成果**：
   - 已完成的项目/版本
   - 解决的技术问题
   - 优化的效果和数据
   - 产出的文档和方案

### 第五步：根据报告类型生成内容

#### 周报生成

周报支持两种输入模式：

**模式一：基于每日工作记录**

用户提供每日工作记录文件或笔记，Claude 汇总整理成周报：

1. 读取每日工作记录
2. 按项目/模块归类工作内容
3. 提取关键进度和成果
4. 识别遇到的问题
5. 根据上下文推断下周计划

**模式二：基于口述/列点**

用户直接口述或简单列出本周工作，Claude 按标准格式整理：

1. 收集用户提供的工作要点
2. 询问补充信息（进度、成果、问题等）
3. 按标准周报格式整理输出

**周报输出格式**

按照固定模板格式生成，详见 [templates/weekly-report.md](templates/weekly-report.md)

#### 月报生成

月报重点突出当月主要工作和进度，格式灵活，建议包含：

1. **本月重点工作**：按项目/模块汇总当月主要工作
2. **工作进度**：各项工作的完成情况和进度百分比
3. **主要成果**：当月交付的成果、解决的问题
4. **遇到的问题**：阻塞项、风险点
5. **下月计划**：下月重点工作安排

#### 季报生成

季报重点突出季度工作总结和阶段性成果，格式灵活，建议包含：

1. **季度工作概述**：本季度主要工作方向和目标
2. **重点项目进展**：按项目汇总季度内的工作和进度
3. **阶段性成果**：本季度完成的里程碑、交付物
4. **问题与改进**：遇到的主要问题及解决方案
5. **下季度计划**：下季度重点工作规划

#### 年终总结生成

按照固定模板格式生成，包含以下板块：

- 业绩达成（1500-3000 字）
- 个人成长（400-700 字）
- 成长计划（400-700 字）

详细模板参见 [templates/year-end.md](templates/year-end.md)

### 第六步：结合规划文档（年终总结适用）

如果提供了规划文档：

1. 提取下一年度的工作重点
2. 识别资源需求
3. 梳理个人成长方向

### 第七步：输出文件

将生成的报告输出为 Markdown 文件，默认保存到与周报相同的目录。

## 重要提示

1. **尊重用户指引**：用户提供的重点工作范围和修正说明优先级最高
2. **客观呈现**：避免夸大成果，用事实和数据说话
3. **突出价值**：强调工作对业务和团队的实际影响
4. **结构清晰**：使用表格和列表提高可读性
5. **周报偏差处理**：
   - 周报可能存在遗漏或描述不准确
   - 根据用户指引进行修正和补充
   - 如有疑问，主动询问用户确认

## 交互示例

### 周报示例（基于每日记录）

```
用户：帮我生成本周的周报

Claude：好的，我需要了解一些信息来生成周报：

1. 请提供本周的每日工作记录文件路径，或者直接告诉我你这周做了哪些工作
2. 本周的时间范围是？（如 2025.01.06 - 2025.01.10）
3. 汇报对象是谁？（用于称呼）
```

### 周报示例（基于口述列点）

```
用户：帮我写周报，这周主要做了：
- AISE 项目文档规范
- Apifox 部署上线
- 代码追踪 MCP 协议开发

Claude：好的，我来帮你整理成周报。请补充以下信息：

1. 各项工作的进度如何？（如：已完成、进行中 80%）
2. 有没有量化的成果？（如：覆盖了多少团队、支持了多少功能）
3. 遇到了什么问题或风险吗？
4. 下周有什么计划？
```

### 月报示例

```
用户：帮我生成 12 月的月报

Claude：好的，我需要了解一些信息来生成月报：

1. 请提供包含 12 月周报的文件路径
2. 你希望重点突出哪些工作？
3. 有哪些内容需要弱化或忽略？
```

### 季报示例

```
用户：帮我生成 Q4 季报

Claude：好的，我需要了解一些信息来生成季报：

1. 请提供包含 Q4（10-12 月）周报的文件路径
2. 本季度有哪些重点项目需要突出？
3. 有哪些内容需要弱化或忽略？
```

### 年终总结示例

```
用户：帮我生成年终总结

Claude：好的，我需要了解一些信息来生成年终总结：

1. 请提供周报文件的路径
2. 是否有下一年度的规划文档？
3. 请告诉我你的岗位信息，以及年内是否有角色变化
4. 有没有参考的格式模板？
5. 请提供一些指引：
   - 你希望重点突出哪些工作？
   - 有哪些内容需要弱化或忽略？
   - 周报中有没有需要修正的地方？
```

## 常见问题处理

### Q: 周报内容太多，总结太长怎么办？

A: 根据用户指引的重点范围进行筛选，次要工作可以合并或简化描述。

### Q: 周报格式不统一怎么办？

A: 尽量识别关键信息（时间、工作内容、结果），格式差异不影响内容提取。

### Q: 用户没有提供规划文档怎么办？

A: 成长计划部分可以根据周报中体现的成长方向和待改进点来撰写，或询问用户补充。

## 周报格式建议

为了更好地支撑各类报告生成，建议用户按照标准格式编写周报。

详见 [templates/weekly-report.md](templates/weekly-report.md)