note (v1)

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

The Note domain is responsible for direct query of minutes when
note_id
is known. It does not backtrack meetings, calendars, Minutes (Miaoji) or document titles, nor does it read Docx content—those belong to

lark-vc

lark-minutes

, and

lark-doc

respectively.

Source of
note_id
: If the entry is a document, first use
docs +fetch --api-version v2 --doc <doc_token>
to read document metadata; the
<vc-transcribe-tab vc-node-id="..."></vc-transcribe-tab>
in the response indicates a VC original record block, where the value of the
vc-node-id
attribute is the
note_id
used by the Note domain. This is an explicit attribute mapping; do not infer
note_id
from
doc_token
, title, content or backlink.
Only minute title available: When the user says "Query the verbatim transcript / original record / who said what of xx minute" and there is no
note_id
,
meeting_id
,
calendar_event_id
,
minute_token
, meeting number or Miaoji URL, first search for the minute document and fetch its content. Only the
<vc-transcribe-tab vc-node-id="...">
in the content can enter this skill; otherwise, only read the explicit "verbatim record/transcript" Docx link in the content, do not force entry into the Note domain.

Core Concepts

Note (Meeting Minutes): A minute entity generated after a meeting, identified by
```
note_id
```
.
Display Type (
note_display_type
): Distinguishes minute forms, with values
```
unknown
```
/
```
normal
```
/
```
unified
```
.
- ```
normal
```
  (Normal Minute): The minute content and verbatim transcript are two independent Feishu documents, corresponding to
```
note_doc_token
```
  and
```
verbatim_doc_token
```
  respectively.
- ```
unified
```
  : Minute content, AI-generated products, and verbatim records are presented together; the verbatim transcript is no longer an independent document and must be retrieved by
```
note +transcript
```
  using
```
note_id
```
  .
Document Tokens:
```
note_doc_token
```
(AI intelligent minute main document),
```
verbatim_doc_token
```
(normal minute verbatim transcript document),
```
shared_doc_tokens
```
(in-meeting shared documents). After obtaining the tokens, pass them to lark-doc to read the content.

Trigger Rules

User Expression	Command / Route
Known `note_id` , query minute details / minute type / associated document tokens	`note +detail --note-id NOTE_ID`
Only natural language minute title, user requests verbatim transcript / original record / who said what	Do not enter this skill; route to lark-drive / lark-doc first, then return after obtaining `vc-node-id`
`docs +fetch --api-version v2` returns `<vc-transcribe-tab vc-node-id="...">` , need to enter Note domain	Use the value of `vc-node-id` attribute as `NOTE_ID` : `note +detail --note-id <vc-node-id>`
Known `note_id` , query unified original record / verbatim transcript	`note +transcript --note-id NOTE_ID`
Known `note_id` , read minute content	First use `note +detail` to get `note_doc_token` , then call `docs +fetch --api-version v2 --doc <note_doc_token>`

Routing Rules (Decision based on

note_display_type

after obtaining detail)

Condition	Agent Follow-up Action
User requests minute content / summary / to-dos / sections	`docs +fetch --api-version v2 --doc <note_doc_token>`
`note_display_type=normal` , user requests verbatim transcript / who said what	`docs +fetch --api-version v2 --doc <verbatim_doc_token>`
`note_display_type=unknown` , and `verbatim_doc_token` is not empty, user requests verbatim transcript / who said what	`docs +fetch --api-version v2 --doc <verbatim_doc_token>` ; do not assume it is unified
`note_display_type=unknown` , and no available verbatim transcript token	If the current result comes from `vc +notes` , you can recheck with `note +detail --note-id <note_id>` once; if it is still `unknown` with no verbatim transcript token after `note +detail` , stop retrying and inform the user that the verbatim transcript entry cannot be determined
`note_display_type=unified` , user requests verbatim transcript / original record / who said what	`note +transcript --note-id <note_id>`

The discriminant key is
note_display_type
, not whether
verbatim_doc_token
is empty. The
verbatim_doc_token
of unified minutes may also have a value, but the verbatim transcript of unified minutes should uniformly use
note +transcript
(more structured output).

Forbidden Rules

Do not process
```
meeting_id
```
— this is the entry point of lark-vc.
Do not process
```
calendar_event_id
```
— this is the entry point of lark-vc.
Do not process
```
minute_token
```
— this is the entry point of lark-vc (minute product index) / lark-minutes (Miaoji basic information and media).
Do not process natural language minute title search — first search for the minute document and fetch its content; only the explicit
```
vc-node-id
```
in
```
<vc-transcribe-tab>
```
from the fetch result can be used as
```
note_id
```
, and the "verbatim record/transcript" Docx link in normal minutes is still read by lark-doc.
Do not read Docx content — pass the document token to lark-doc after obtaining it.
Do not infer
```
note_id
```
from minute content or
```
doc_token
```
; only the explicit
```
vc-node-id
```
attribute in
```
<vc-transcribe-tab>
```
from the
```
docs +fetch --api-version v2
```
result can be used as
```
note_id
```
.

Shortcuts (Recommended for Priority Use)

Shortcuts are advanced encapsulations of common operations (

lark-cli note +<verb> [flags]

Shortcut	Description
`+detail`	Get note detail (display type, document tokens) by note_id
`+transcript`	Fetch the unified note transcript and save it to a file

When using the
```
+detail
```
command, you must read references/lark-note-detail.md.
When using the
```
+transcript
```
command, you must read references/lark-note-transcript.md.

Permission Table

Method	Required scope
`+detail`	`vc:note:read`
`+transcript`	`vc:note:read`

References

lark-vc — Locate note_id from meeting_id / calendar_event_id / minute_token
lark-doc — Read minute content / normal verbatim transcript document content
lark-minutes — Miaoji basic information and media download
lark-shared — Authentication and global parameters

lark-note

NPX Install

Tags

SKILL.md Content (Chinese)