SuperAPI AI Directory

lark-workflow-weekly-report

Office & productivity

View repository

Updated 10-16 09:57

About this skill

Automatic Weekly Report Generation Workflow

CRITICAL — Before starting, you MUST first use the Read tool to read lark-shared/SKILL.md, which contains authentication, permission handling, and security rules.

Applicable Scenarios

  • "Help me write a weekly report" / "Generate this week's work summary"

  • "What did I do this week" / "Organize this week's work"

  • "Weekly report" / "weekly report"

  • "Review last week's work" / "Last week's summary"

  • "Help me summarize what I completed this week"

  • standup-report(Official): aggregatesthe day'scalendar events + to-dos → time-oriented

  • meeting-summary(Official): only summarizes meeting minutes

  • This Skill: aggregatesthe entire week'smulti-domain data → results-oriented(what you completed, not just what you attended)

Prerequisites

Only supports user identity. Before execution, ensure authorization has been granted:

lark-cli auth login --domain calendar,task,drive,vc,doc

Workflow

{周一~今天} ─┬─► calendar +agenda         ──► 本周会议列表
             ├─► task +get-my-tasks        ──► 分配给我的任务
             ├─► task +get-related-tasks   ──► 我创建/关注的任务(v1.0.11+)
             ├─► drive(搜索文档活动)      ──► 本周编辑/创建的文档(可选)
             └─► vc +search → vc +notes    ──► 本周会议纪要(可选)
                         │
                         ▼
                   AI 聚合分析
                         │
            ┌────────────┼────────────┐
            ▼            ▼            ▼
        本周完成     下周计划      风险与问题
            │
            ▼
        周报文档(可选:docs +create 写回飞书)

Step 1: Determine the weekly report time range

Inference rules:

  • "Weekly report" / "this week" → this Monday 00:00:00 ~ current time
  • "Last week's weekly report" / "last week" → last Monday 00:00:00 ~ last Sunday 23:59:59

Note: Date conversion must call system commands; do not calculate mentally.

# 获取本周一的日期(macOS)
date -v-monday "+%Y-%m-%dT00:00:00%z"
# 获取当前时间
date "+%Y-%m-%dT%H:%M:%S%z"

# 获取上周一和上周日(macOS)
date -v-monday -v-7d "+%Y-%m-%dT00:00:00%z"
date -v-sunday -v-7d "+%Y-%m-%dT23:59:59%z"

Step 2: Get this week's calendar events

Refer to lark-calendar/SKILL.md。

lark-cli calendar +agenda --start "<monday>T00:00:00+08:00" --end "<today>T23:59:59+08:00"

Extract from the calendar events:

  • Total number of meetings and total duration
  • List of key meetings (excluding repetitive meetings such as daily stand-ups)
  • Important decisions participated in

Step 3: Get task completion status

Refer to lark-task/SKILL.md。

A. Get tasks assigned to me:

# 获取分配给我的任务(包含已完成和未完成)
lark-cli task +get-my-tasks --page-all --format json

B. Get tasks related to me (recommended, v1.0.11+):

# 获取我创建的、我关注的任务(覆盖面更广)
lark-cli task +get-related-tasks --page-all --format json

Tip:+get-related-tasks can capture tasks you created but assigned to others (such as work you delegated), as well as tasks you follow but are not the owner of. Deduplicate and merge the results of A + B by guid to generate a more complete weekly report.

Extract from the merged task list:

  • Completed tasks: tasks that changed from "incomplete" to "completed" this week (determined by completion time)
  • In-progress tasks: tasks still incomplete but updated this week
  • Overdue tasks: tasks whose due date falls within this week but are not completed
  • Tasks I delegated: tasks I created but assigned to others (from +get-related-tasks --created-by-me)

Note:--page-all may return a large amount of data. If the task volume is too large (>50 items), it is recommended to inform the user that the current return is the full dataset, and the AI will only extract tasks relevant to this week.

Step 4: Get document activity (optional)

Refer to lark-drive/SKILL.md。

Fallback handling: If the drive domain is not authorized or returns empty, skip this step.

# 搜索最近编辑过的文档
lark-cli drive files search --data '{"search_key":"","count":20,"order_by":"EditedTime","asc":false}' --format json

Filter from the results the documents edited/created this week (determined by edit_time / create_time ).

Step 5: Get meeting minutes summaries (optional)

Reference lark-vc/SKILL.md。

Fallback handling: If the vc domain is unauthorized or returns empty, skip this step.

# 搜索本周会议
lark-cli vc +search --start "<monday>" --end "<today>" --format json --page-size 30

# 获取会议纪要文档 token
lark-cli vc +notes --meeting-ids "id1,id2,...,idN"

Note: There is no need to read the full text of the minutes; only the minutes titles and document links are needed. AI can infer a summary of the meeting content based on the meeting titles and minutes titles.

Step 6: AI generates the weekly report

Integrate the results of Step 2–5 into the following structure:

## 周报({YYYY-MM-DD} ~ {YYYY-MM-DD})

### 📌 本周概要
> 一段话总结本周核心工作成果(由 AI 根据以下数据生成)

### ✅ 本周完成
1. **{任务/事项 1}**
   - 完成时间:YYYY-MM-DD
   - 相关文档:[文档名](链接)(如有)
   
2. **{任务/事项 2}**
   - 完成时间:YYYY-MM-DD

### 🔄 进行中
1. **{任务/事项}** — 当前进度描述 — 预计完成日期

### 📅 主要会议
| 日期 | 会议 | 关键结论 | 纪要链接 |
|------|------|---------|---------|
| 周一 | 产品需求评审 | 确定 Q2 方向 | [链接] |
| 周三 | 技术方案讨论 | 采用方案 B | [链接] |

### 📄 文档产出
- [X 设计文档](链接) — 新建
- [Y 需求文档](链接) — 更新

### 📋 下周计划
1. {基于进行中任务和会议决策推导的计划 1}
2. {计划 2}
3. {计划 3}

### ⚠️ 风险与问题
- {基于逾期任务发现的风险}
- {需要协调解决的问题}

Generation rules:

  1. Completed this week: Extract first from the list of completed tasks, and supplement with outcomes inferred from document outputs and meeting conclusions
  2. Plan for next week: Derive from the remaining parts of “in-progress tasks” + follow-up action items extracted from meeting minutes
  3. Risks and issues: Extract from overdue tasks and unfinished key tasks
  4. Summary: Generate a summary of no more than 100 words based on all data
  5. Meeting compression: If there are more than 10 meetings, list only the 5-8 most important ones and fold the rest into "N other regular meetings"

Step 7: Generate the document (optional, when requested by the user)

Reference lark-doc/SKILL.md。

lark-cli docs +create --title "周报 (<start> ~ <end>)" --markdown "<内容>"
# 或追加到已有文档
lark-cli docs +update --doc "<url_or_token>" --mode append --markdown "<内容>"

Permissions table

Step Command Required scope Required
Calendar calendar +agenda calendar:calendar.event:read ✅ Required
My tasks task +get-my-tasks task:task:read ✅ Required
Related tasks task +get-related-tasks task:task:read Recommended (v1.0.11+)
Document activity drive files search drive:drive:readonly Optional
Meeting records vc +search / vc +notes vc:meeting:readonly Optional
Generate document docs +create / docs +update docx:document:write Optional (when writing back)

Reference