| 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 年）
第二步：收集必要信息
在开始之前，需要向用户确认以下信息：
- 周报文件路径：包含周报的文件（支持 .rtf、.docx、.md、.txt 格式）
- 规划文档路径（可选，年终总结推荐提供）：年度工作规划文档
- 补充信息（可选）：对于事项的罗列和规划完成进展
- 参考格式（可选）：报告的格式模板或参考图片
- 角色信息（年终总结必填）：
- 当前岗位
- 期间是否有角色变化（如从项目经理转为架构师）
- 角色变化的时间节点
- 用户指引（重要）：
- 重点工作范围：用户希望重点突出哪些工作
- 需要弱化或忽略的内容
- 周报中可能存在的偏差或需要修正的地方
- 其他特殊要求
第三步：读取并解析文件
使用以下方式读取 rtf 文件：
textutil -stdout -convert txt "文件路径.rtf"
对于 .md 或 .txt 文件，直接使用 Read 工具读取。
第四步：分析周报内容
- 按时间线梳理：将周报按时间顺序整理，筛选指定时间范围内的周报
- 按角色分段：如有角色变化，区分不同阶段的工作内容
- 提取关键工作：
- 重点项目和版本
- 技术方案和架构工作
- 团队管理工作（如适用）
- 跨团队协作
- 问题处理和优化
- 识别成果：
- 已完成的项目/版本
- 解决的技术问题
- 优化的效果和数据
- 产出的文档和方案
第五步：根据报告类型生成内容
周报生成
周报支持两种输入模式：
模式一：基于每日工作记录
用户提供每日工作记录文件或笔记，Claude 汇总整理成周报：
- 读取每日工作记录
- 按项目/模块归类工作内容
- 提取关键进度和成果
- 识别遇到的问题
- 根据上下文推断下周计划
模式二：基于口述/列点
用户直接口述或简单列出本周工作，Claude 按标准格式整理：
- 收集用户提供的工作要点
- 询问补充信息（进度、成果、问题等）
- 按标准周报格式整理输出
周报输出格式
按照固定模板格式生成，详见 templates/weekly-report.md
月报生成
月报重点突出当月主要工作和进度，格式灵活，建议包含：
- 本月重点工作：按项目/模块汇总当月主要工作
- 工作进度：各项工作的完成情况和进度百分比
- 主要成果：当月交付的成果、解决的问题
- 遇到的问题：阻塞项、风险点
- 下月计划：下月重点工作安排
季报生成
季报重点突出季度工作总结和阶段性成果，格式灵活，建议包含：
- 季度工作概述：本季度主要工作方向和目标
- 重点项目进展：按项目汇总季度内的工作和进度
- 阶段性成果：本季度完成的里程碑、交付物
- 问题与改进：遇到的主要问题及解决方案
- 下季度计划：下季度重点工作规划
年终总结生成
按照固定模板格式生成，包含以下板块：
- 业绩达成（1500-3000 字）
- 个人成长（400-700 字）
- 成长计划（400-700 字）
详细模板参见 templates/year-end.md
第六步：结合规划文档（年终总结适用）
如果提供了规划文档：
- 提取下一年度的工作重点
- 识别资源需求
- 梳理个人成长方向
第七步：输出文件
将生成的报告输出为 Markdown 文件，默认保存到与周报相同的目录。
重要提示
- 尊重用户指引：用户提供的重点工作范围和修正说明优先级最高
- 客观呈现：避免夸大成果，用事实和数据说话
- 突出价值：强调工作对业务和团队的实际影响
- 结构清晰：使用表格和列表提高可读性
- 周报偏差处理：
- 周报可能存在遗漏或描述不准确
- 根据用户指引进行修正和补充
- 如有疑问，主动询问用户确认
交互示例
周报示例（基于每日记录）
用户：帮我生成本周的周报
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
