Agent Skills
› fanfan-de/anybox
› lark-markdown
lark-markdown
GitHub用于在飞书Drive中管理原生Markdown文件。支持创建、读取、局部补丁替换及覆盖更新。需先加载lark-shared处理认证，涉及文档导入或云空间操作时请切换至lark-drive。
Trigger Scenarios
用户需要创建新的Markdown文件
用户需要读取Drive中的Markdown内容
用户需要对Markdown进行文本替换或局部编辑
用户需要覆盖更新现有Markdown文件
Install
npx skills add fanfan-de/anybox --skill lark-markdown -g -y
SKILL.md
Frontmatter
{
"name": "lark-markdown",
"version": "1.1.0",
"metadata": {
"cliHelp": "lark-cli markdown --help",
"requires": {
"bins": [
"lark-cli"
]
}
},
"description": "飞书 Markdown：查看、创建、上传和编辑 Markdown 文件。当用户需要创建或编辑 Markdown 文件、读取或修改时使用。"
}
markdown (v1)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理
快速决策
- 用户要上传、创建一个原生
.md文件，使用lark-cli markdown +create - 用户要读取 Drive 里某个
.md文件内容，使用lark-cli markdown +fetch - 用户要对 Markdown 文件做局部文本替换 / 正则替换，优先使用
lark-cli markdown +patch - 用户要覆盖更新 Drive 里某个
.md文件内容，使用lark-cli markdown +overwrite - 用户要把本地 Markdown 导入成在线新版文档（docx），不要用本 skill，改用
lark-drive的lark-cli drive +import --type docx - 用户要对 Markdown 文件做rename / move / delete / 搜索 / 权限 / 评论等云空间操作，不要留在本 skill，切到
lark-drive
核心边界
- 本 skill 处理的是 Drive 中作为普通文件存储的 Markdown，不是 docx 文档
--name和本地--file文件名都必须显式带.md后缀；不满足时 shortcut 会直接报错--content支持：- 直接传字符串
@file从本地文件读取内容-从 stdin 读取内容
markdown +patch的内部语义是：先完整下载 Markdown，再本地替换，再整文件覆盖上传markdown +patch不是服务端原子 patch；它是 CLI 侧编排出来的局部更新能力markdown +patch当前只支持单组--pattern/--contentmarkdown +patch替换后的最终内容不能为空；如果替换后整篇 Markdown 变成空字符串，CLI 会直接报错，不会上传空文件--file只接受本地.md文件路径
Shortcuts（推荐优先使用）
Shortcut 是对常用操作的高级封装（lark-cli markdown +<verb> [flags]）。有 Shortcut 的操作优先使用。
| Shortcut | 说明 |
|---|---|
+create |
Create a Markdown file in Drive |
+fetch |
Fetch a Markdown file from Drive |
+patch |
Patch a Markdown file in Drive via fetch-local-replace-overwrite |
+overwrite |
Overwrite an existing Markdown file in Drive |
参考
- lark-shared — 认证和全局参数
- lark-drive — Drive 文件管理、导入 docx、move/delete/search 等
Version History
- 08dc189 Current 2026-07-05 18:58
