lark-markdown

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

markdown (v1)

markdown (v1)

CRITICAL — 开始前 MUST 先用 Read 工具读取
../lark-shared/SKILL.md
,其中包含认证、权限处理
CRITICAL — MUST use the Read tool to read
../lark-shared/SKILL.md
before starting, which contains authentication and permission handling

快速决策

Quick Decision

  • 用户要上传、创建一个原生
    .md
    文件
    ,使用
    lark-cli markdown +create
  • 用户要读取 Drive 里某个
    .md
    文件内容
    ,使用
    lark-cli markdown +fetch
  • 用户要覆盖更新 Drive 里某个
    .md
    文件内容
    ,使用
    lark-cli markdown +overwrite
  • 用户要把本地 Markdown 导入成在线新版文档(docx),不要用本 skill,改用
    lark-drive
    lark-cli drive +import --type docx
  • 用户要对 Markdown 文件做rename / move / delete / 搜索 / 权限 / 评论等云空间操作,不要留在本 skill,切到
    lark-drive
  • When users want to upload and create a native
    .md
    file
    , use
    lark-cli markdown +create
  • When users want to read the content of a
    .md
    file in Drive
    , use
    lark-cli markdown +fetch
  • When users want to overwrite and update the content of a
    .md
    file in Drive
    , use
    lark-cli markdown +overwrite
  • When users want to import local Markdown into an online new document (docx), do not use this skill; instead, use
    lark-cli drive +import --type docx
    from
    lark-drive
  • When users need to perform cloud space operations such as rename / move / delete / search / permission / comment on Markdown files, do not stay in this skill; switch to
    lark-drive

核心边界

Core Boundaries

  • 本 skill 处理的是 Drive 中作为普通文件存储的 Markdown,不是 docx 文档
  • --name
    和本地
    --file
    文件名都必须显式带
    .md
    后缀;不满足时 shortcut 会直接报错
  • --content
    支持:
    • 直接传字符串
    • @file
      从本地文件读取内容
    • -
      从 stdin 读取内容
  • --file
    只接受本地
    .md
    文件路径
  • This skill handles Markdown stored as regular files in Drive, not docx documents
  • Both
    --name
    and the local
    --file
    filename must explicitly include the
    .md
    suffix; the shortcut will directly report an error if this requirement is not met
  • --content
    supports:
    • Directly passing a string
    • @file
      reading content from a local file
    • -
      reading content from stdin
  • --file
    only accepts local
    .md
    file paths

Shortcuts(推荐优先使用)

Shortcuts (Recommended for Priority Use)

Shortcut 是对常用操作的高级封装(
lark-cli markdown +<verb> [flags]
)。有 Shortcut 的操作优先使用。
Shortcut说明
+create
Create a Markdown file in Drive
+fetch
Fetch a Markdown file from Drive
+overwrite
Overwrite an existing Markdown file in Drive
Shortcuts are advanced encapsulations of common operations (
lark-cli markdown +<verb> [flags]
). Prioritize using operations with Shortcuts.
ShortcutDescription
+create
Create a Markdown file in Drive
+fetch
Fetch a Markdown file from Drive
+overwrite
Overwrite an existing Markdown file in Drive

参考

References

  • lark-shared — 认证和全局参数
  • lark-drive — Drive 文件管理、导入 docx、move/delete/search 等
  • lark-shared — Authentication and global parameters
  • lark-drive — Drive file management, docx import, move/delete/search, etc.