lark-monthly-report

name	lark-monthly-report
description	自动生成月报。当员工或组长在飞书说"本月月报/生成月报/月度总结/monthly report"时触发。在周报数据之上叠加月度维度：跨周工时趋势、里程碑完成率、关键成果、风险复盘、下月规划，按"成果数据 / 关键项目 / 问题复盘 / 下月规划"结构输出。比周报更强调趋势和结论，适合向更高级别汇报。

lark-monthly-report — 月报生成

月报 ≠ 四周周报拼起来。月报要回答的是"这个月到底推进了什么、卡在哪、下个月怎么打"。

何时触发

• "本月月报 / 月度总结 / monthly report"
• "研发部 8 月月报"
• "给我出 CRM-V2 项目月报"
• 每月最后一个工作日 17:00 cron 推送草稿

依赖

• lark-cli base：读 worklogs / tasks / projects / weekly_reports
• lark-cli docs：写入月报文档（月报一般比周报文长，用飞书文档更合适）
• lark-cli slides（可选）：管理层版本生成汇报 PPT
• lark-cli im：回传卡片

月报与周报的区别

维度	周报	月报
时间粒度	天	周/周对比
重点	做了啥、下周干啥	做成了啥、趋势、风险
数据呈现	明细表	趋势图 + 里程碑
读者	直属领导	可能上两级
语言密度	事项罗列	结论先行
篇幅	1 屏	3-5 屏 / 1 页 A4

输出模板（个人月报）

# 张三 · 2026 年 8 月月报

## 一、本月一句话

> 主推进 CRM-V2 登录模块从 30% 到 90%，参与 APP-V3 推送接入；
> 修了 3 个线上 P0 bug，面试 8 人，通过 2 人

## 二、数据看板

| 指标 | 本月 | 上月 | 变化 |
|---|---:|---:|---:|
| 总工时 | 176h | 184h | -8h |
| 项目工时占比 | CRM 55% / APP 25% / 日常 20% | — | — |
| 完成任务 | 14 | 11 | +3 |
| 推进中任务 | 5 | 6 | -1 |
| 阻塞任务 | 1 | 0 | +1 ⚠️ |
| 加班天数 | 4 | 6 | -2 |

### 工时分布（按周）
| 周次 | CRM-V2 | APP-V3 | 日常 | 合计 |
|---|---:|---:|---:|---:|
| W31 | 24 | 8 | 8 | 40 |
| W32 | 22 | 10 | 8 | 40 |
| W33 | 22 | 10 | 8 | 40 |
| W34 | 18 | 14 | 8 | 40 |
| **合计** | **86** | **42** | **32** | **160** |

## 三、关键成果（Top 5）

1. 🏆 **CRM-V2 登录模块从 30% → 90%**（T001）
   - 对接 SSO、重构 token 刷新逻辑、修复 2 个并发 bug
   - 下周联调，预计 8/18 提测
2. 🏆 **客户列表分页 bug 修复上线**（T002）
   - 影响 1200+ 客户，修完后客诉降为 0
3. 🏆 **APP-V3 推送 iOS 端打通**（T004）
   - Android 卡在通道申请，下月优先解决
4. 🏆 **面试 8 人，通过 2 人**
   - 1 个前端 offer 已接，1 个后端终面中
5. 🏆 **输出《SSO 接入踩坑 12 条》文档**
   - 被 3 个同事引用到自己的项目

## 四、项目进度

| 项目 | 月初 | 月末 | 变化 | 评价 |
|---|---:|---:|---:|---|
| CRM-V2 | 40% | 70% | ↑30 | 🟢 正常 |
| APP-V3 | 60% | 85% | ↑25 | 🟡 推送延期 |
| DATA-PLAT | 0% | 10% | ↑10 | 🟢 按计划 |
| EFF-TOOL | 0% | 5% | ↑5 | 🟡 需求还没定 |

## 五、问题复盘

### 1. Android 推送通道延期 5 天
- 现象：8/5 提的工单，8/15 还没批
- 根因：运维审批链没明确 SLA
- 已做：找李四催了，8/16 终于批了
- 改进：下月起所有跨团队工单 48h 无响应自动升级

### 2. CRM 登录模块预估偏乐观
- 原估 16h，实际已花 28h，还有 4h 收尾
- 根因：SSO 文档和实际接口不一致，走了弯路
- 改进：涉及第三方接口的任务，预估 ×1.5

## 六、下月规划

### 关键目标
1. CRM-V2 登录模块 8/18 提测，8/25 上线
2. APP-V3 推送全端打通，8/30 灰度
3. EFF-TOOL 完成需求评审，9 月初进入开发

### 能力提升
- 系统学习 Android 推送原理（4h）
- 输出 2 篇技术文档

### 需要的支持
- 运维侧：建立跨团队审批 SLA
- 产品侧：EFF-TOOL 边界 8/20 前确定

项目月报（给总监看）

额外强调：

• 里程碑达成率：计划 5 个，完成 4 个，延期 1 个
• 人力投入分布：各成员投入工时 + 加班情况
• 风险登记册：新增/升级/关闭的风险
• 跨团队依赖：哪些事需要上级协调
• 下月关键里程碑：3-5 个

生成步骤

1. 确定月份：默认上月或本月
2. 拉数据：
   • worklogs 整月
   • tasks 月初 vs 月末快照（需要 tasks 有进度变更历史，或从 worklogs 反推）
   • weekly_reports 整月 4 份
   • projects 表当前状态
3. 聚合：
   • 按周 × 项目做交叉表
   • 按任务算"月初进度→月末进度"
   • 统计完成任务数、阻塞任务数、加班天数
4. 里程碑匹配：
   • 从 tasks 表筛选 due_date 在本月且 status=已完成的
   • 筛选计划本月完成但未完成的（延期项）
5. AI 生成：
   • 一句话总结（最重要）
   • Top 5 成果（从完成任务里按 impact 选）
   • 问题复盘（从阻塞任务 + 周报里反复出现的卡点抽）
6. 输出：
   • 默认 IM 卡片（精简版）
   • 回复"详细版"→ 写飞书文档
   • 回复"PPT 版"→ 用 slides 出汇报 PPT

设计原则

• 结论先行：第一段就是"这个月到底咋样"
• 数据说话：每个结论后面跟数字
• 不回避问题：问题复盘要写根因和改进，不能只列现象
• 下月规划可量化：不用"继续推进"这种废话，要给日期和里程碑

不做什么

• 不堆砌四周周报
• 不做绩效评定（月报是工作记录，不是考核表）
• 不自动上报：必须员工/组长确认