# Lark Monthly Report

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

- Skill: `tjxj/lark-monthly-report` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tjxj/lark-monthly-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tjxj/lark-monthly-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tjxj (https://skillmd.com/u/tjxj)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tjxj/lark-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 |

## 输出模板（个人月报）

```markdown
# 张三 · 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

## 设计原则

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

## 不做什么

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