reports-summary

name	reports-summary
description	专业的周报汇总助手，负责将团队成员的周报整理成标准格式的汇总报告，并支持转换为 Word 文档。当用户提及"周报"、"汇总"、"总结"、"报告整理"，或需要处理 .docx 周报文件、生成团队工作汇总、将 Markdown 转为 Word 文档时，**必须**调用此技能。即使只提到"看看这周的工作"、"整理一下大家的工作内容"等模糊表述，也应该使用此技能。

Weekly Report Summary Assistant

这是一个专门用于处理团队周报的技能。它可以帮助你从零散的员工周报中提取关键信息，生成结构清晰的汇总报告，并将其转换为正式的 Word 文档。

依赖环境 (Prerequisites)

此技能需要以下 Python 库支持：

• python-docx - 用于读取和生成 Word 文档
• markdown - 用于解析 Markdown 格式
• beautifulsoup4 - 用于 HTML 处理

如果运行脚本时发现缺少依赖，可安装这些库。

工作流程 (Workflows)

场景 1: 从周报文件生成汇总

触发条件: 用户提供了周报文件或目录路径，或直接粘贴周报内容

• Step 1: 读取周报内容

  • 检查用户是否明确指定了文件路径或目录
  • 如果未指定，检查当前目录下是否有 .docx 文件
  • 如果找到文件，调用 scripts/read_reports.py 读取所有 Word 文档
  • 如果用户直接提供文本内容，跳过文件读取步骤
  • 错误处理: 如果目录为空或没有 .docx 文件，友好地提示用户并提供替代方案

• Step 2: 内容分析与提取

  • 亮点提取: 识别关键成就、重要进展以及对部门目标有重大贡献的事项
  • 工作总结: 撰写一段 150-200 字以内的整体工作总结，突出主要成果和影响
  • 分类汇总: 将所有员工的工作内容按项目或主题分类（如：DeepSeek 一体机、易嘉云算力平台等）
  • 去重合并: 如果多人参与同一项目，合并相似内容，避免重复
  • 下周计划: 提炼出 5-10 条重要下周工作项，按优先级排序

• Step 3: 生成 Markdown 报告

  • 按照 输出格式模板 组织内容
  • 日期提取: 从各员工周报标题或内容中提取日期信息（如"3.10-3.14"、"3月10日-14日"、"2026.03.10-2026.03.14"等格式）
  • 日期统一: 将提取到的日期统一格式化为 yyyy.mm.dd-yyyy.mm.dd 格式（如 2026.03.10-2026.03.14）
  • 如果各员工周报日期不一致，取最早开始日期和最晚结束日期作为汇总范围
  • 如果无法从任何周报中提取到日期，再询问用户:"请提供周报的时间范围（如：2026.03.10-2026.03.14）"
  • 使用三级标题 (###) 标识不同项目/主题

• Step 4: 保存 Markdown 文件

  • 使用标题作为文件名保存，格式：工作周报-{部门名称}-{开始日期}-{结束日期}.md
  • 例如：工作周报-产品设计及研发-2026.03.10-2026.03.14.md

• Step 5: 用户确认

  • 展示生成的 Markdown 预览
  • 告知 Markdown 文件保存路径
  • 询问用户是否满意，或是否需要调整（如：添加/删除项目、修改表述）
  • 询问是否需要转换为 Word 文档

场景 2: Markdown 转 Word

触发条件: 用户已有 Markdown 格式的周报，需要转换为 Word 文档

• Step 1: 确认转换需求

  • 确认源 Markdown 文件路径
  • 自动命名: Word 文档名称与 Markdown 标题保持一致
  • 如 工作周报-产品设计及研发-2026.03.10-2026.03.14.md → 工作周报-产品设计及研发-2026.03.10-2026.03.14.docx
  • 用户可以指定其他文件名或路径

• Step 2: 执行转换

  • 必须使用 scripts/md_to_docx.py 脚本进行转换
  • 命令格式: python3 scripts/md_to_docx.py <input.md> <output.docx>
  • 验证输出文件是否成功生成

• Step 3: 交付结果

  • 告知用户 Word 文档的保存路径
  • 简要说明文档包含的内容

工具脚本说明 (Tools Reference)

read_reports.py - 批量读取周报

用途: 读取单个 Word 文档或整个目录中的所有 .docx 文件

用法:

scripts/read_reports.py <file_or_directory_path>

输出: 返回 JSON 格式的文件名和内容映射

示例:

scripts/read_reports.py ./weekly_reports/
# 输出: {"张三_周报.docx": "本周完成了...", "李四_周报.docx": "本周进展..."}

错误处理:

• 如果路径不存在 → 提示用户检查路径
• 如果目录中没有 .docx 文件 → 提示用户目录为空，询问是否提供其他路径
• 如果文件读取失败 → 记录错误但继续处理其他文件

md_to_docx.py - Markdown 转 Word

用途: 将 Markdown 格式的周报转换为格式规范的 Word 文档

用法:

scripts/md_to_docx.py <markdown_file_path> <word_output_path>

示例:

scripts/md_to_docx.py summary.md "周报汇总_2026.03.10-2026.03.14.docx"

功能特性:

• 自动应用模板格式（template.docx）
• 支持标题层级转换
• 保持列表和段落格式

OutputFormat

请严格按照以下 Markdown 格式生成周报汇总：

# 工作周报-{部门名称}-{开始日期}-{结束日期}

## {部门名称}

{150-200字的工作总结，概括本周主要成果和进展}

### 1、{项目A名称}

{第一段：描述主要完成的工作内容和成果，可包含具体数据}

{第二段：补充说明其他相关工作（可选）}

{第三段：如有更多细节需要补充（可选）}

### 2、{项目B名称}

{按照同样的格式描述该项目的工作内容，一到三段话}

### {其他项目或主题}

{继续按照上述格式描述}

## 下周工作计划

- {下周工作计划第一条，简明扼要}
- {下周工作计划第二条}
- {下周工作计划第三条}
- ...

格式说明

元素	格式要求
工作总结	150-200字，客观概括，段首不加符号
项目标题	### 数字、项目名称，如 ### 1、DeepSeek一体机
项目内容	一到三段话的工作总结，每段独立成行，段首不加 -，客观描述主要进展
下周计划	## 下周工作计划 下使用列表，每行以 - 开头

日期格式

日期处理规则

自动提取: 系统会尝试从周报标题和内容中自动识别日期，支持的格式包括：

• 3.10-3.14 → 转换为 2026.03.10-2026.03.14（年份取当前年）
• 3月10日-14日 → 转换为 2026.03.10-2026.03.14
• 2026.03.10-03.14 → 转换为 2026.03.10-2026.03.14
• 2026年3月10日至3月14日 → 转换为 2026.03.10-2026.03.14

多文件日期合并:

• 如果所有员工周报日期一致，直接使用该日期
• 如果日期不一致，取最早的开始日期和最晚的结束日期

手动确认:

• 如果无法自动提取到日期，询问:"请提供周报的时间范围（如：2026.03.10-2026.03.14）"
• 提取到日期后，向用户确认:"检测到周报日期为 2026.03.10-2026.03.14，是否正确？"

示例 (Examples)

示例 1: 处理多个周报文件

输入: 用户说:"帮我汇总一下团队这周的工作，文件在 ./reports/ 目录里，日期是3月10日到14日"

执行步骤:

1. 检查 ./reports/ 目录，发现 张三.docx、李四.docx、王五.docx
2. 运行: scripts/read_reports.py ./reports/
3. 分析内容，提取关键信息
4. 生成 Markdown 汇总

输出:

# 工作周报-产品设计及研发-2026.03.10-2026.03.14

## 三、产品设计及研发

本周团队主要聚焦在DeepSeek一体机API开发和易嘉云平台UI设计两大核心项目。整体进展顺利，关键技术难点得到突破，为产品按时交付奠定了坚实基础。

### 1、DeepSeek一体机

本周完成了API接口开发，实现了模型推理接口的封装，优化了接口响应速度，平均响应时间从500ms降低至200ms。修复了3个高优先级bug，包括内存泄漏和并发处理问题。编写了接口文档并完成了代码审查。

协助测试团队完成集成测试，记录了15个测试用例，编写了项目部署文档。

### 2、易嘉云平台

完成了用户界面设计，包括Dashboard和设置页面。与产品团队确认了需求变更，调整了登录流程的设计。制作了高保真原型图，完成了设计评审，整理了设计规范和组件库文档。

## 下周工作计划

- 进行DeepSeek一体机压力测试，验证系统在高并发下的稳定性
- 开始易嘉云平台前端开发，实现登录和Dashboard页面
- 准备上线前的环境配置和最终检查
- 编写技术文档、操作手册和运维手册
- 与后端团队对接API接口

示例 2: 直接处理文本内容

输入: 用户粘贴:"张三：完成了登录模块开发。李四：设计了首页界面。王五：写了测试用例。"

输出: 直接生成标准格式的 Markdown（同上格式）

示例 3: Markdown 转 Word

输入: 用户说:"帮我把 工作周报-产品设计及研发-2026.03.10-2026.03.14.md 转成 Word 文档"

执行步骤:

1. 读取 Markdown 文件的标题
2. 自动使用与标题一致的文件名
3. 运行转换命令:

python3 scripts/md_to_docx.py 工作周报-产品设计及研发-2026.03.10-2026.03.14.md 工作周报-产品设计及研发-2026.03.10-2026.03.14.docx

输出: "已成功将 Markdown 转换为 Word 文档，保存在: 工作周报-产品设计及研发-2026.03.10-2026.03.14.docx"

最佳实践 (Best Practices)

• 客观专业: 保持语气客观、专业，避免口语化表达（如"挺好的"、"还不错"）
• 精炼准确: 每条总结应言简意赅，避免冗长描述，聚焦结果而非过程
• 数据支撑: 如有具体数据（如"提升50%"、"修复3个bug"），优先保留
• 结构清晰: 严格遵守各级标题结构，确保文档层次分明
• 隐私保护: 在最终汇总中隐去具体员工姓名，除非特定事项必须提及负责人
• 合并相似项: 如果多人做同一件事，合并为一条，如"团队完成API接口开发"
• 优先级排序: 下周工作计划按重要程度排序，最重要的放前面
• 文件命名一致: Markdown 文件和 Word 文档的文件名应与标题保持一致

常见错误处理 (Error Handling)

问题	处理方式
目录不存在	"指定的路径不存在，请检查路径是否正确，或上传文件到当前目录"
目录为空	"该目录下没有找到 .docx 文件。请：1) 确认路径正确 2) 直接粘贴周报内容 3) 上传文件"
文件读取失败	"部分文件读取失败，已成功读取X个文件。失败的文件：[文件名]，原因：[错误信息]"
内容为空	"读取到的内容为空，请检查文件是否正常"
日期未提供	"请提供周报的时间范围（如：2026.03.10-2026.03.14）"

提示词优化建议

如果用户说：

• "看看大家这周干了什么" → 询问是否有周报文件，或直接请用户粘贴内容
• "整理一下工作" → 确认是要生成周报汇总
• "把Markdown转成Word" → 确认文件路径并执行转换
• "生成周报" → 询问数据来源（文件/文本）和时间范围