# 飞书Skill家族二拆：仿写者全军覆没，护城河根本不在提示词里 ## 概述 五周前，本栏深拆过生态里最大的Skill家族——飞书lark全家桶，当时选的样本是入口件lark-doc和共享底座lark-shared。本期第二轮拆解换一个问题：既然SKILL.md是公开的、命令是公开的，为什么几个月过去，社区仿写品没有一件活下来？答案藏在这套体系的工程结构里：**真价值在Go写成的CLI和自动生成的命令层，提示词只是操作手册的封面**。本文沿用8月29日skills.sh快照与两份SKILL.md原文（v1.0.0/v1.1.0），把「克隆为什么打不过原厂」拆成四道护城河，逐段讲透。 ## 评测对比表 | 维度（权重） | lark-doc（入口件） | lark-shared（底座） | 家族整体 | 社区仿写品（lark-mcp等） | |---|---|---|---|---| | 功能完整度 25% | ★★★★★ | ★★★★ | ★★★★ | ★★ | | 设计质量 25% | ★★★★★ | ★★★★★ | ★★★★ | ★★ | | 实战效果 20% | ★★★★ | ★★★★ | ★★★★ | ★★ | | 上手难度 15% | ★★★ | ★★★ | ★★★ | ★★★★ | | 社区活跃度 15% | ★★★★★ | ★★★★★ | ★★★★★ | ★ | | **加权总分** | **4.50** | **4.25** | **4.00** | **2.15** | 仿写品上手难度反而更高分，是这套对比里最讽刺的一行：装一个纯提示词克隆确实零门槛，但装完几乎干不成事。 ## 生态坐标：一个家族，三张门牌 先复习盘子有多大。据skills.sh 2026年8月29日快照：单款Skill安装量冠军是find-skills（约300万），而飞书一个家族两渠道合计约2200万——open.feishu.cn域名名下24个lark系列合计约1420万，larksuite/cli仓库名下约790万，国际版域名open.larksuite.com另有数千级长尾。作为对照，microsoft/azure-skills家族约750万，remotion-dev约487万，都不及飞书单渠道。 ```mermaid flowchart TD A["lark-doc 同名Skill"] B["open.feishu.cn
约1420万安装"] C["larksuite/cli
约790万安装"] D["open.larksuite.com
国际版数千级"] B -->|域名直发| A C -->|仓库随附| A D -->|国际版域名| A E["skills.sh 总榜"] -->|三渠道分开计数| F["排名与信任度叠加"] ``` 三渠道发布同名Skill、安装量分开计数，这个「分发矩阵」本身就是生态里少见的打法。而同榜上还躺着一排社区仿写品：whatevertogo/feishuskill的lark-mcp约3100安装、feishu-create-doc等数十个克隆，头牌也不到原版的零头中的零头——原版lark-doc单款约60万安装，是最强仿写品的近200倍。 ## 第一道护城河：提示词只是封面，引擎在CLI里 官方CLI（larksuite/cli，Go语言，npm包`@larksuite/cli`）的自我定位是"built for humans and AI Agents"，内建三层命令体系： 1. **Shortcuts（`+`前缀）**：带智能默认值和dry-run预览的高级封装，如`lark-cli calendar +agenda`； 2. **API Commands**：从飞书开放平台元数据**自动生成**、经质量门禁筛选的100+命令，与平台端点一一对应； 3. **Raw API**：`lark-cli api GET /open-apis/...`直调任意端点，覆盖官方宣称的2500+ API。 克隆者能抄走SKILL.md的每一个字，却抄不走这个CLI。SKILL.md里所有指令都指向`lark-cli`这个二进制——复制提示词而不复刻引擎，等于抄了一本健身教材却没借到杠铃。更致命的是第二层：100+命令是从平台元数据自动生成并过质量门禁的，平台API一更新，原厂重新生成一遍即可，克隆者拿到的静态文本从抄走那天起就开始腐烂。 ## 第二道护城河：把坑预判进文本的「症状→动作」写法 看lark-doc SKILL.md（v1.0.0）最值钱的一段——URL格式对照表： | URL格式 | Token类型 | 处理方式 | |---|---|---| | `/docx/` `/doc/` `/sheets/` | `file_token` | 直接使用 | | `/wiki/` | `wiki_token` | ⚠️ **不能直接使用**，需先查询换取真实`obj_token` | | `/drive/folder/` | `folder_token` | 作为文件夹token使用 | 「知识库链接背后的token不是文档token」是飞书API真实的高频坑：模型拿到`/wiki/wikcnXXX`链接，最自然的反应是拿路径里的token调文档接口，然后收到莫名报错。SKILL.md的做法不是写一句「注意wiki链接需特殊处理」，而是给出完整动作链：先跑`lark-cli wiki spaces get_node`查节点，从返回的`obj_type`/`obj_token`取真实值，再按类型路由到`docx.*`/`sheets.*`/`bitable.*`对应API，文末还附了一棵ASCII资源关系树帮模型建立心智模型。 **这类内容抄不走的原因不是字，是账**：每一条「症状→动作」背后都是原厂踩过的真实事故。仿写者没有踩坑史，抄来的表格也不知道哪些行该标⚠️。 ```mermaid flowchart TD U["用户想「找一个表格」"] -->|口语触发| E["lark-doc 入口件"] E --> F["docs +search 资源发现"] F --> G{"找到什么类型"} G -->|电子表格| S["转交 lark-sheets"] G -->|文档| D["lark-doc 自处理"] D --> H{"是wiki链接吗"} H -->|是| W["get_node 换真实token"] W --> I{"obj_type是什么"} I -->|docx| J["文档API"] I -->|bitable| K["转交 lark-base"] H -->|否| J E -.->|开头必读| SH["lark-shared 底座"] SH --> L{"退出码是10吗"} L -->|是| M["停下向用户求确认"] L -->|否| N["正常执行"] ``` ## 第三道护城河：入口路由与转交经济学 lark-doc的frontmatter里藏着一处容易被当成废话的设计，description末尾写道：「如果用户是想按名称或关键词先定位电子表格、报表等云空间对象，也优先使用本skill的docs +search做资源发现」——文档Skill主动把本属lark-sheets的流量接到自己手里，先做资源发现再转交。 这是**入口件（entry-point skill）设计**：宁可自己多接一步，不让模型在20多个Skill里犹豫。家族分工由此成立——lark-doc管资源发现，lark-sheets/lark-base管各自领域，lark-whiteboard接画板，边界声明写明「lark-doc不能直接编辑已有画板内容，但可以新建空白画板」，并把转交路径一并给出。模型知道「这事我干不了，但我知道该找谁」，比多十个功能更能减少胡编。 克隆品抄得走单份SKILL.md，抄不走**整族的路由拓扑**：转交路径、共享底座引用、reference索引互相咬合，缺一件就断链。这和微服务一样——抄一个服务容易，抄一套服务网格难。 ## 第四道护城河：安全是协议，不是嘱咐 lark-shared底座（v1.1.0）里最硬的一条：退出码10不是错误，而是高风险写入操作的确认门禁——必须停下、向用户展示`action`/`risk`与关键参数、取得显式同意后，把确认flag追加到原始argv末尾重试，**绝不静默加确认flag绕过**。 注意这个门禁的实现位置：在CLI里。模型收到的退出码是引擎吐出的物理信号，绕过动作本身被提示词明文禁止——human-in-the-loop被做成了协议，不是靠模型自觉。同在底座里的还有两条被真实事故喂出来的准则：`--as bot`查用户资源会返回**空成功而非报错**（静默失败型大坑）；判断成功要看`ok == true`而不是`code == 0`（成功信封没有顶层code字段，按OpenAPI老格式判断会把所有成功误判为失败）。 再加上文末的Reference强触发索引——「遇到missing_scopes读哪份文件、准备执行high-risk-write读哪份」的条件→动作确定性映射——这套东西合起来是一台**防胡编机器**。仿写品没有CLI吐退出码，整条安全链从根上不存在。 ## 全家桶的账单：护城河的另一面 优势背后是真实的成本，这也是它不适合所有人的原因： - **初始化摩擦**：装CLI、`config init`建应用、OAuth授权一个不能少，官方估计3分钟，前提是你有飞书开放平台账号； - **每次会话多读一个25KB级底座文件**：CRITICAL指令要求开工前必读lark-shared，token成本精确但存在； - **数据回报披露**：README写明CLI默认随请求上报操作系统类型和硬件型号作风控信号，隐私敏感者可用`lark-cli config risk-control off`关闭。 ## 安装与使用 ```bash # 1. 安装CLI（npm分发，Go二进制） npx @larksuite/cli@latest install # 2. 安装Skill到全局（Claude Code / Cursor等20+ Agent通用） npx skills add larksuite/cli -y -g # 3. 配置应用凭证（后台运行，输出授权URL交给用户） lark-cli config init --new # 4. 登录（--recommend自动勾选常用scope） lark-cli auth login --recommend # 5. 验证 lark-cli calendar +agenda ``` ## 适用与不适用 **适合**：团队已在飞书/Lark上，想让Agent读写文档、表格、多维表格、日历、会议纪要；想把周报、站会纪要这类重复操作交给Agent；以及想研究「CLI+Skill」范式的开发者——这两份SKILL.md加一个CLI仓库，就是目前公开可见的最完整企业级Skill教材。 **不适合**：不用飞书生态的团队（全家桶绑死lark-cli，没账号一件都用不了）；只想轻量读公开文档、不想建应用走OAuth的场景；期待即装即用的新手——它是需要10分钟初始化的驾驶舱，不是玩具。 ## 推荐排行榜 - **最值得抄的一段**：lark-shared的Reference强触发索引表。任何超过200行的Skill都该有这张「条件→必读文件」映射。 - **最值得记住的一个判断**：Skill的护城河排序是「引擎＞数据＞提示词」。提示词是全家桶里最容易被抄也最不值钱的部分，原厂早就把宝押在了CLI和自动生成命令层。 - **生态意义**：飞书证明了厂商入场Skill生态的正确姿势——不是把API文档塞给模型，而是把API包装成人机共用的CLI，再用提示词当驾驶手册。仿写潮的全军覆没则是这条路线的最好反证。 ## 参考来源 1. [Skills Leaderboard — skills.sh](https://skills.sh/) — 2026-08-29快照：find-skills约3.0M、lark家族约14.2M/7.9M、azure-skills约7.5M、remotion-dev约4.87M及仿写品安装量均出自此处 2. [larksuite/cli — GitHub](https://github.com/larksuite/cli) — 官方README：三层命令体系、风控数据上报披露、安装流程 3. [lark-doc SKILL.md 原文](https://raw.githubusercontent.com/larksuite/cli/main/skills/lark-doc/SKILL.md) — 入口件拆解第一手文本（v1.0.0） 4. [lark-shared SKILL.md 原文](https://raw.githubusercontent.com/larksuite/cli/main/skills/lark-shared/SKILL.md) — 共享底座全文（v1.1.0），退出码10门禁与强触发索引出处 5. [skills.sh 搜索页：lark-doc](https://skills.sh/search?q=lark-doc) — 三渠道安装量对照与社区仿写品长尾数据 > [!tip] 51学通信知识星球 > **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 > **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 > **当前规模**：5200 篇主题 / 990 个回答，198 元/年。 > **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 > **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。