lark-workflow-meeting-summary

Meeting Minutes Summary Workflow

CRITICAL, Before starting, you MUST use the Read tool to read ../lark-shared/SKILL.md, which contains information on authentication and permission handling. Then read ../lark-vc/SKILL.md to understand operations related to meeting minutes.

CRITICAL, Before starting, you MUST use the Read tool to read ../lark-vc/references/vc-domain-boundaries.md. Failure to read this will lead to errors in command usage, decision making regarding meeting artifacts, and judgment of domain boundary responsibilities:

1. Understand the relationship and division of responsibilities between Calendar & VC, and Meeting Artifacts & Documents.
2. Understand the relationship between meeting artifacts (Minutes and Transcripts), for example: The generation conditions for Minutes and Transcripts are independent of each other.
3. Understand the components of different meeting artifacts to decide which artifact data to use based on requirements.
4. Understand the standard process for meeting summarization, analysis, and information extraction.

Applicable Scenarios

• "Help me organize this week's meeting minutes" / "Summarize recent meetings" / "Generate a weekly meeting report"
• "See what meetings were held today" / "Review the meetings held over the past week"

Prerequisites

Only user identity is supported. Ensure authorization is granted before execution:

lark-cli auth login --domain vc        # Basic (Query + Minutes)
lark-cli auth login --domain vc,drive   # Includes reading minute document content and generating documents

Workflow

{Time Range} ─► vc +search ──► Meeting List (meeting_ids)
                   │
                   ▼
               vc +notes ──► Minutes document tokens
                   │
                   ▼
               drive metas batch_query Minutes metadata
                   │
                   ▼
               Structured Report

Step 1: Determine the Time Range

Default is the past 7 days. Inference rules: "today" -> current day, "this week" -> Monday of this week to now, "last week" -> Monday to Sunday of last week, "this month" -> 1st to now.

Note: Date conversion must call system commands (such as date); do not calculate mentally. Time range parameters must be formatted according to actual CLI requirements (usually YYYY-MM-DD or ISO 8601).

Step 2: Query Meeting Records

# page-size maximum is 30
lark-cli vc +search --start "<YYYY-MM-DD>" --end "<YYYY-MM-DD>" --format json --page-size 30

• Time range splitting: The maximum search time range is 1 month. To search for a longer time range, it must be split into multiple queries of one month each.
• --end is the date including the current day (i.e., when checking "today", fill in today for both start and end).
• --format json outputs in JSON format; you are better at parsing JSON data.
• --page-size 30 maximum 30 items per page.
• When page_token exists, you must continue to paginate and collect all id fields (meeting-id).

Step 3: Obtain Minutes Metadata

1. Query meeting-related minutes information

lark-cli vc +notes --meeting-ids "id1,id2,...,idN"   

• Query meeting minutes based on the meeting-id collected in the previous step.
• A maximum of 50 minutes can be queried in a single batch; if more than 50, batch calls are required.
• Some meetings return no notes available; mark these as "No minutes" in the final output.
• Record the note_doc_token (Minutes document Token) and verbatim_doc_token (Transcript document Token) for each meeting.

2. Obtain links for Minutes documents and Transcript documents

# Learn command usage
lark-cli schema drive.metas.batch_query

# Batch obtain links for minutes and transcripts: maximum 10 documents per query
lark-cli drive metas batch_query --data '{"request_docs": [{"doc_type": "docx", "doc_token": "<doc_token>"}], "with_url": true}'

Step 4: Organize the Minutes Report

Select the output format based on the time span:

• Single-day summary ("today"/"yesterday"): Use the title "Today's Meeting Overview", and list the meeting time, topic, minutes link, and transcript link for each meeting.
• Multi-day/Weekly report ("this week"/"past 7 days", etc.): Use the title "Meeting Minutes Weekly Report", including overview statistics and details for each meeting.

Step 5: Generate Document (Optional, when requested by the user)

Read ../lark-doc/SKILL.md to learn cloud document skills.

lark-cli docs +create --api-version v2 --doc-format markdown --content $'<title>Meeting Minutes Summary (<start> - <end>)</title>\n<Content>'
# Or append to an existing document
lark-cli docs +update --api-version v2 --doc "<url_or_token>" --command append --doc-format markdown --content $'<Content>'

References

• lark-shared, Authentication, permissions (Must read)
• lark-vc, Detailed usage of +search, +notes
• lark-doc, Detailed usage of +fetch, +create, +update