智能报告生成助手 v3.1

新手30秒入门

这个 Skill 干什么？ 一句话生成报告，一步发送邮件。

直接复制使用：

"帮我生成今天的日报：完成了用户模块，修复3个BUG，明天写测试"
"生成这周周报，从这份Excel里提取工作内容，用163发给我领导"
"把这份工作记录整理成月报PPT，发给张总zhang@company.com"
"帮我补写昨天的日报，昨天做了：..."

使用前准备（首次使用才需要）：

1. 告诉我你的姓名和部门（自动记住，以后不用再说）
2. 如果要发邮件，告诉我邮箱地址（会引导你配置SMTP，约2分钟）

能力边界说明

✅ 擅长处理（开箱即用）

⚠️ 需要素材才能做

❌ 超出范围（附替代方案）

核心能力

• 全类型报告：日报 / 周报 / 月报 / 季报 / 年报，自动识别意图
• 多源输入：口述工作内容 / 上传文件（Word/Excel/PDF/TXT）/ 混合输入
• 多格式导出：Word（.docx）/ Excel（.xlsx）/ PPT（.pptx）/ PDF / Markdown
• 邮件发送：内置 18 种主流邮箱 SMTP 预设，自动识别配置，引导授权码
• 持久化归档：所有报告以 Markdown 存储，支持历史查询和二次编辑

安全与数据隐私

隐私保护原则

1. 不存储明文密码：邮箱授权码/密码通过 cryptography.fernet 加密存储，KEY 文件单独存放于 config/.fernet_key
2. 不泄露报告内容：所有生成的报告保存在本地 skill_data/ 目录，不自动上传到任何云端
3. 发送前确认：发送邮件前总会展示收件人和报告摘要，用户确认后才实际发送
4. 收件人级别控制：根据收件人类型（领导/团队/全员）自动调整报告详细度和保密级别
• 直属领导：完整版（含全部数据和分析）
• 团队成员：协作版（侧重协作事项和进度同步）
• 全员公告：公开版（去除敏感数据和内部评估术语）

安全注意事项

• ⚠️ 不要在工作内容中包含核心机密数据（如数据库密码、客户身份证号），这些内容会被写入报告
• ⚠️ 邮箱密码/授权码只在首次配置时输入一次，不要在对话正文中发送密码
• ⚠️ 使用第三方邮箱（Gmail/Outlook）发送时，邮件内容走对应服务商的 SMTP 协议传输
• ⚠️ 如果公司有 DLP（数据防泄漏）策略，请确认发送含工作内容的邮件是否符合合规要求

禁止行为

• 🚫 不在未获用户明确指令时主动发送邮件
• 🚫 不伪造发件人身份（From 地址必须与 SMTP 登录账号一致）
• 🚫 不向未验证的地址批量发送邮件（防止被标记为垃圾邮件）
• 🚫 不将用户报告内容用于训练或日志分析之外的任何用途

触发与意图识别

各功能精确触发条件

意图识别规则

当用户一句话同时包含多个意图时，按以下优先级处理：

1. 检测报告类型（日/周/月/季/年）
2. 检测输出格式（Word/PPT/Excel/PDF 或默认 Word+Markdown）
3. 检测发送意图（有收件人 → 邮件发送流程）
4. 检测内容来源（文件上传 / 口述 / 两者兼有）
5. 检测特殊操作（补写/配置/查询历史报告）

运行时行为约束

输出准确性规则

• 禁止在不确定领域胡编：如果工作内容不足，先给出一个"假设示例版本"（标注"以下为示例内容，请确认后替换"），并列出需要补充的具体信息
• 每个关键数据注明来源：如从文件抽取，标注"数据来源：工作记录.xlsx · Sheet: 本周任务"
• 区分事实和建议：工作内容是事实（如实呈现），下阶段计划是建议（标注为"拟定计划"）

降级与兜底策略

当输入信息不足时，按以下策略降级处理，不挂起也不给空回复：

错误提示规范

所有面向用户的错误提示必须满足：

• 不暴露技术细节：不说 ImportError: No module named docx，而说"生成 Word 需要安装依赖，正在自动安装中..."
• 格式为"缺少[具体项]+如何补充"：不说"参数错误"，而说"缺少收件人邮箱，请提供收件人地址，例如 zhang@company.com"
• 提供下一步操作：每条错误信息后紧跟一个明确的可执行操作

主工作流

阶段 0：初始化检查

检查 skill_data/report_generator/config/user_profile.md 是否存在
├─ 不存在 → 引导用户完成首次配置（姓名/部门/职位/常用收件人）
└─ 存在 → 读取用户档案，个性化报告

阶段 1：内容输入与抽取

输入来源处理：

抽取结构（标准化输出）：

extracted_content:
  completed_tasks:    # 已完成工作（带成果描述）
  in_progress_tasks:  # 进行中工作（带进度百分比）
  blocked_items:      # 待解决问题/障碍
  key_metrics:        # 关键数据指标
  next_plans:         # 下阶段计划
  highlights:         # 亮点/成就（用于标题摘要）

阶段 2：报告生成

加载 references/report_templates.md 获取模板规范。

自动填充规则：

• 标题：[用户姓名][部门] YYYY年MM月DD日 [报告类型]
• 周期标注：日报=当日，周报=本周一~周日，月报=本月1日~月末
• 字数控制：日报 300-500 字，周报 500-800 字，月报 800-1500 字，季/年报 1500-3000 字
• 数据亮点：自动加粗关键数字和成果
• 问题标注：用 ⚠️ 标记障碍项

阶段 3：文件导出

根据用户指定格式或默认 Word+Markdown 双格式导出：

调用 scripts/generate_report.py
  参数: report_type, content_dict, output_format, template_name, output_path
  输出: 生成文件路径列表

存储路径：skill_data/report_generator/reports/YYYY/MM/{report_type}/YYYYMMDD_{report_type}.{ext}

阶段 4：邮件发送（含邮箱配置）

4.1 读取邮箱配置：

读取 config/email_settings.md
├─ 无配置 → 进入"首次配置向导"（见邮箱配置模块）
├─ 有单账户 → 直接使用
└─ 有多账户 → 根据语境选择（"工作"→company，"个人"→personal）

4.2 SMTP 自动识别：

提取发件邮箱后缀 → 查询 references/smtp_presets.md
├─ 命中预设 → 自动填充 host/port/ssl/auth_type
├─ 腾讯/阿里/网易企业邮箱 → 询问具体服务商
└─ 未命中 → 进入自定义 SMTP 配置

4.3 发送流程：

调用 scripts/send_email.py
  参数: from_account, to, cc, bcc, subject, report_path, html_template
  返回: success/error + 日志写入 logs/email_send_log.md

4.4 失败重试：自动重试 3 次（2s → 4s → 8s 指数退避），仍失败则保留草稿并告知用户。

阶段 5：归档

将最终 Markdown 版报告追加写入 reports/YYYY/MM/{type}/index.md（月度汇总索引）。

邮箱配置模块

首次配置向导

1. 询问发件邮箱地址
2. 自动识别服务商 → 显示 SMTP 配置（host/port/ssl）
3. 根据 auth_type 给出授权码获取指引（见下表）
4. 测试发送（发至自身验证）
5. 保存至 config/email_settings.md

授权码获取指引

多账户切换规则

异常处理

文件存储结构

skill_data/report_generator/
├── config/
│   ├── user_profile.md          # 用户信息（姓名/部门/职位）
│   ├── email_settings.md        # 多账户邮箱配置（加密密码）
│   └── skill_settings.md        # 全局设置（默认报告类型/格式/语言）
├── templates/
│   ├── daily_default.md         # 日报模板
│   ├── weekly_default.md        # 周报模板
│   ├── monthly_default.md       # 月报模板
│   ├── quarterly_default.md     # 季报模板
│   ├── yearly_default.md        # 年报模板
│   ├── email_html_default.html  # HTML 邮件模板
│   └── custom/                  # 用户自定义模板
├── recipients/
│   ├── leaders.md               # 领导收件人列表
│   ├── team.md                  # 团队成员列表
│   └── all_company.md           # 全公司发送列表
├── reports/
│   └── YYYY/MM/{type}/          # 按年/月/类型归档
├── logs/
│   ├── YYYY-MM-DD_actions.md    # 操作日志
│   └── email_send_log.md        # 邮件发送记录
└── outputs/
    └── YYYY-MM-DD/              # 当日所有导出文件

交互示例

示例1 - 快速日报：

> 用户："帮我生成今天的日报：完成了用户模块开发，修复了3个BUG，明天继续写测试用例"

> → AI 自动抽取 → 生成日报 Word 文件 → 询问是否发送

示例2 - 上传文件生成周报：

> 用户：上传工作记录.xlsx → "帮我生成本周周报并发给张总"

> → 解析文件 → 生成周报 → 读取收件人配置（张总） → 发送邮件

示例3 - 首次使用 Gmail：

> 用户："用我的 Gmail 发送报告"

> → 识别 Gmail → 提示需要应用专用密码 → 给出 Google 账户设置链接和步骤 → 引导输入16位密码 → 测试发送 → 保存配置

示例4 - 多账户切换：

> 用户："用工作邮箱发给部门群"

> → 自动选择 company_exmail 账户 → 查询 team.md 获取收件人 → 发送

调用脚本说明

所有脚本位于 scripts/ 目录，调用前确认 Python 依赖已安装（见 scripts/requirements.txt）：

FAQ

Q1：工作内容太少/太杂，AI 帮我总结得不好怎么办？

答：垃圾进垃圾出。提供工作内容时尽量包含"具体事项+量化数据+做了什么"。示例对比：

• ❌ "开发了功能"
• ✅ "完成了用户登录模块：实现了手机号+验证码登录，前端 React Hooks，后端 Node.js + Redis，测试覆盖率 90%"

如果实在没时间整理，直接说"先给我一个假设版本"，AI 会填入示例内容并标注待确认。

Q2：我的公司有固定报告格式，可以适配吗？

答：把公司模板 Markdown 文件放入 templates/custom/ 目录。使用时说"用我的 XX 模板生成周报"。HTML 邮件模板也可自定义（templates/custom/email_日报.html）。

Q3：生成的文件打开乱码怎么办？

答：用 WPS 或 Office 2016+ 打开（UTF-8 编码）。Excel 用"数据 → 自文本/CSV → UTF-8"导入。纯文本用 VS Code 查看。

Q4：能用 QQ 邮箱发送给多人吗？

答：可以。说"发给张总和李经理"，用逗号分隔。需要抄送/密送时说"抄送给xx"或"密送给xx"。QQ 邮箱的每日发信限额请参考 QQ 邮箱官方说明。

Q5：报告自动保存在哪里？能查看上周的报告吗？

答：保存在 skill_data/report_generator/reports/YYYY/MM/{type}/ 目录。说"查看上周的周报"或"打开上个月的月报汇总"，AI 会定位并读取对应文件。

Q6：可以设置每天自动生成日报吗？

答：可以。说"帮我设置每天18:00自动生成日报并发给张总"。WorkBuddy 的自动化机制会在指定时间触发 Skill。

Q7：如果有多个项目并行，能按项目分别生成报告吗？

答：可以。说"按项目分组生成日报"或"单独生成项目A的进度报告"。AI 会从工作内容中识别项目标签并分组输出。

Q8：手机收邮件排版会很乱吗？

答：不会。HTML 邮件模板采用响应式设计，在手机邮件客户端（QQ邮箱APP / 网易邮箱大师 / Gmail APP）上均会自适应缩放到合适的阅读尺寸。

> 更多 FAQ（工具兼容、定制化、故障排查）见 references/faq-deep.md

受众说明

定制化使用指南

参考资料

• references/smtp_presets.md：所有 18 种支持邮箱的 SMTP 完整配置
• references/report_templates.md：日/周/月/季/年报的 Markdown 模板规范
• references/email_html_template.md：HTML 邮件美化模板说明与 Jinja2 变量表
• references/anti-patterns.md：7 种常见错误用法 + 改进对比案例 + 禁忌清单
• references/faq-deep.md：18 道深度 FAQ（垂直领域/工具兼容/定制化/安全/故障排查）
• scripts/requirements.txt：Python 依赖清单（含可选依赖标注）
• assets/email_html_default.html：响应式 HTML 邮件默认模板