周报生成器

周报写作的三个常见痛点

工程师写周报时经常遇到三类问题：一是内容空洞，满篇"推进了XX项目"却找不到具体产出；二是结构混乱，把技术细节、进度汇报、风险预警混在一起，读者抓不住重点；三是格式维护成本高，每次提交前都要手动调整排版。这个技能针对的是"从零散记录到结构化汇报"这一环节，而不是替代你思考工作内容本身。

工作原理

输入引导与默认策略

技能在 Step 1 会主动询问三个维度：报告类型（日报/周报/月报/年报）、时间段（如"本周"或"2026年7月"）、工作领域（技术/市场/产品等）。如果用户只说一句"帮我写个周报"，技能不会直接生成内容，而是逐项追问关键参数，避免输出泛泛而谈的模板。

结构化分析维度

Step 3 的核心是将用户提供的原始信息映射到五个固定维度：

• 核心成果：量化指标或里程碑
• 重点项目：进度、预期、风险
• 协作配合：跨部门沟通与资源协调
• 问题与解决：困难描述与应对方案
• 下周计划：具体目标与时间节点

这个结构强迫你把"本周做了什么"翻译成"价值与风险"，而不是流水账。

三版本输出策略

Step 5 会生成三个版本的 Markdown 周报：精炼版只保留核心成果和下周计划，适合快速浏览；完整版包含所有模块，用于正式提交；优化建议版在完整版基础上标注哪些句子可以更精简。这种分层策略避免了"一份文档满足所有场景"的折中设计。

Word 导出机制

Step 6 可选调用 scripts/export_word.py 脚本，通过 generate_report_docx(report_data, output_path) 函数生成 .docx 文件。脚本默认保存到 ~/桌面/周报/周报_YYYYMMDD.docx，用户可自定义路径。Word 格式预设了标题样式（品牌蓝 #1A73E8、微软雅黑）、三列表格（任务/状态/备注）和固定行距（18磅），减少手动调整格式的时间。

适用边界

这个技能依赖你提供的原始信息质量。如果你只输入"本周推进了项目A"，即使结构化分析也无法凭空生成数据点。技能会在信息不足时追问，但不会替代你回忆工作细节。

Word 导出功能依赖 python-docx 库，脚本执行失败时会提示安装命令。如果目标路径不存在或权限不足，需要用户手动确认路径。

技能不处理图片、表格附件或复杂格式的导入，只接受文本形式的任务列表或草稿。如果你需要从 Jira、Trello 或其他工具直接同步数据，需要先手动整理成文本再粘贴给技能。