用途
work-report 是一个工作报告生成器，用于生成周报、月报、季度报和年终总结。当用户提到“周报”“月报”“季报”“季度报”“年终总结”“年度总结”，或英文 weekly report、monthly report、quarterly report、annual summary、yearly review，或者需要生成各类工作报告时使用此技能。
报告类型
技能覆盖四类报告，各自的时间范围、输入来源、主要内容和格式要求如下：
- 周报：时间范围为本週；输入来源为每日工作记录或口述列点；主要内容为本周工作、下周计划；格式为固定格式，见模板。
- 月报：时间范围为当月 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 会询问：请提供本周的每日工作记录文件路径，或者直接告诉我你这周做了哪些工作；本周的时间范围是（如 2025.01.06 - 2025.01.10）；汇报对象是谁（用于称呼）。
周报示例（基于口述列点）：用户说“帮我写周报，这周主要做了：AISE 项目文档规范、Apifox 部署上线、代码追踪 MCP 协议开发”，Claude 会请用户补充：本周的工作目标是什么；各项工作的进度如何（如已完成、进行中 80%）；有没有需要总结的成果、问题或未完成事项；有什么感想或改进建议；（可选）有没有发现无效工作或浪费现象；（可选）岗位提升方面有什么进展。
月报示例：用户说“帮我生成 12 月的月报”，Claude 会询问：请提供包含 12 月周报的文件路径；你希望重点突出哪些工作；有哪些内容需要弱化或忽略。
季报示例：用户说“帮我生成 Q4 季报”，Claude 会询问：请提供包含 Q4（10-12 月）周报的文件路径；本季度有哪些重点项目需要突出；有哪些内容需要弱化或忽略。
年终总结示例：用户说“帮我生成年终总结”，Claude 会询问：请提供周报文件的路径；是否有下一年度的规划文档；请告诉我你的岗位信息，以及年内是否有角色变化；有没有参考的格式模板；请提供一些指引（你希望重点突出哪些工作、有哪些内容需要弱化或忽略、周报中有没有需要修正的地方）。
常见问题处理
Q: 周报内容太多，总结太长怎么办？A: 根据用户指引的重点范围进行筛选，次要工作可以合并或简化描述。
Q: 周报格式不统一怎么办？A: 尽量识别关键信息（时间、工作内容、结果），格式差异不影响内容提取。
Q: 用户没有提供规划文档怎么办？A: 成长计划部分可以根据周报中体现的成长方向和待改进点来撰写，或询问用户补充。
周报格式建议
为了更好地支撑各类报告生成，建议用户按照标准格式编写周报。详见 templates/weekly-report.md。