work-report
SKILL.md
工作报告生成器
生成周报、月报、季度报和年终总结。
报告类型
| 类型 | 时间范围 | 输入来源 | 主要内容 | 格式要求 |
|---|---|---|---|---|
| 周报 | 本周 | 每日工作记录/口述列点 | 本周工作、下周计划 | 固定格式,见模板 |
| 月报 | 当月 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: 成长计划部分可以根据周报中体现的成长方向和待改进点来撰写,或询问用户补充。
周报格式建议
为了更好地支撑各类报告生成,建议用户按照标准格式编写周报。
Weekly Installs
6
Repository
ab300819/skillsFirst Seen
3 days ago
Installed on
claude-code5
opencode4
antigravity4
gemini-cli4
windsurf3
codex3