| 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_reportslark-cli docs：写入月报文档（月报一般比周报文长，用飞书文档更合适）lark-cli slides（可选）：管理层版本生成汇报 PPTlark-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 个
生成步骤
- 确定月份：默认上月或本月
- 拉数据：
- worklogs 整月
- tasks 月初 vs 月末快照（需要 tasks 有进度变更历史，或从 worklogs 反推）
- weekly_reports 整月 4 份
- projects 表当前状态
- 聚合：
- 按周 × 项目做交叉表
- 按任务算"月初进度→月末进度"
- 统计完成任务数、阻塞任务数、加班天数
- 里程碑匹配：
- 从 tasks 表筛选 due_date 在本月且 status=已完成的
- 筛选计划本月完成但未完成的（延期项）
- AI 生成：
- 一句话总结（最重要）
- Top 5 成果（从完成任务里按 impact 选）
- 问题复盘（从阻塞任务 + 周报里反复出现的卡点抽）
- 输出：
- 默认 IM 卡片（精简版）
- 回复"详细版"→ 写飞书文档
- 回复"PPT 版"→ 用 slides 出汇报 PPT
设计原则
- 结论先行：第一段就是"这个月到底咋样"
- 数据说话：每个结论后面跟数字
- 不回避问题：问题复盘要写根因和改进，不能只列现象
- 下月规划可量化：不用"继续推进"这种废话，要给日期和里程碑
不做什么
- 不堆砌四周周报
- 不做绩效评定（月报是工作记录，不是考核表）
- 不自动上报：必须员工/组长确认
