五周前，本栏深拆过生态里最大的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万，都不及飞书单渠道。
flowchart TD
A["lark-doc 同名Skill"]
B["open.feishu.cn<br/>约1420万安装"]
C["larksuite/cli<br/>约790万安装"]
D["open.larksuite.com<br/>国际版数千级"]
B -->|域名直发| A
C -->|仓库随附| A
D -->|国际版域名| A
E["skills.sh 总榜"] -->|三渠道分开计数| F["排名与信任度叠加"]
三渠道发布同名Skill、安装量分开计数，这个「分发矩阵」本身就是生态里少见的打法。而同榜上还躺着一排社区仿写品：whatevertogo/feishuskill的lark-mcp约3100安装、feishu-create-doc等数十个克隆，头牌也不到原版的零头中的零头——原版lark-doc单款约60万安装，是最强仿写品的近200倍。
官方CLI（larksuite/cli，Go语言，npm包@larksuite/cli）的自我定位是"built for humans and AI Agents"，内建三层命令体系：
+前缀）：带智能默认值和dry-run预览的高级封装，如lark-cli calendar +agenda；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资源关系树帮模型建立心智模型。
这类内容抄不走的原因不是字，是账：每一条「症状→动作」背后都是原厂踩过的真实事故。仿写者没有踩坑史，抄来的表格也不知道哪些行该标⚠️。
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吐退出码，整条安全链从根上不存在。
优势背后是真实的成本，这也是它不适合所有人的原因：
config init建应用、OAuth授权一个不能少，官方估计3分钟，前提是你有飞书开放平台账号；lark-cli config risk-control off关闭。# 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分钟初始化的驾驶舱，不是玩具。
[!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 等场景全覆盖。