skills/ab300819/skills/work-report

work-report

SKILL.md

工作报告生成器

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

报告类型

类型 时间范围 输入来源 主要内容 格式要求
周报 本周 每日工作记录/口述列点 本周工作、下周计划 固定格式,见模板
月报 当月 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 文件:

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

月报生成

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

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

季报生成

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

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

年终总结生成

按照固定模板格式生成,包含以下板块:

  • 业绩达成(1500-3000 字)
  • 个人成长(400-700 字)
  • 成长计划(400-700 字)

详细模板参见 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

Weekly Installs
6
Repository
ab300819/skills
First Seen
3 days ago
Installed on
claude-code5
opencode4
antigravity4
gemini-cli4
windsurf3
codex3