chore(larksuite-cli): 同步合集子技能至上游最新 / sync collection children to upstream HEAD (#105)

## 问题 / Problem

市场登记的 `larksuite-cli` 合集落后于上游,用户看到的能力清单不准确:

1. **缺少 `lark-meeting`** — 合集只登记 27 个子技能,上游实际有 28 个。而 `lark-meeting`
恰好是会议域**唯一的真业务技能**。
2. **4 个已降级的兼容壳仍按旧描述展示** — 上游已把 `lark-vc` / `lark-vc-agent` /
`lark-minutes` / `lark-note` 改成纯兼容入口(正文只有一句「转
lark-meeting」),但市场里仍是它们退役前的能力描述。用户按描述勾选,会装到 4 个不再承载业务的空壳,却装不到真正干活的
`lark-meeting`。
3. `source.ref` 钉在 2026-06 的提交上。

The registered `larksuite-cli` collection lagged upstream:
`lark-meeting` — the only real business skill in the meeting domain —
was missing, while four skills that upstream has since reduced to
compatibility shims were still advertised with their pre-retirement
descriptions. Users following those descriptions would install four
empty shims and miss the skill that actually does the work.

## 修改 / Changes

- `source.ref`: `4c31323` → `a257fcb`(上游 main,2026-08-31)
- `children`: 27 → 28,补齐 `lark-meeting`
- 4 个兼容壳的描述随之更新为「仅当显式指定时使用,统一交由 lark-meeting 技能处理」
- 同步 sidecar 的 `provenance.content.ref` 与
`spec.collection.childCount`,修复 legacy 与 sidecar 的一致性

`children` 由 `scripts/gen-collection-children.py larksuite-cli`
生成,未手工编辑。

## 验证 / Validation

```
uv run scripts/i18n/validate-i18n.py              → 0 error, 116 warning
uv run scripts/catalog/validate_catalog_metadata.py → 0 error, 116 warning
```

改动前基线同为 `0 error / 116 warning`,**无新增 warning**。

首次提交时只改了 legacy `entry.json`,校验报 3 个 `legacy-consistency` /
`collection-identity` error;stash 改动跑基线对照确认是本次引入后,补齐 sidecar 修复。
This commit is contained in:
2026-09-01 10:00:10 -04:00
committed by GitHub
parent 8265c8f4a9
commit 8ca10741aa
2 changed files with 180 additions and 143 deletions

View File

@@ -29,7 +29,7 @@
"kind": "git",
"repoUrl": "https://github.com/larksuite/cli.git",
"repoBranch": "main",
"ref": "4c31323de1ca878b2070c05f7c3cb66c0de4c767"
"ref": "a257fcbaf9f07787b6c170d9265e9ef273b0c579"
},
"children": [
{
@@ -51,10 +51,10 @@
"version": "1.0.0",
"i18n": {
"zh-CN": {
"shortDesc": "妙搭Spark/Miaoda应用开发与托管应用创建、HTML静态站点发布、本地全栈开发、云端生成迭代。当用户要开发/新建一个系统·工具·平台·应用,或要本地开发 / 云端开发 / 修改 / 部署 / 发布 / 上线 / 拿可分享链接,或用 HTML 做页面·网站·部署到妙搭,或提到妙搭/Spark/Miaoda…"
"shortDesc": "妙搭Spark/Miaoda应用开发与托管应用创建、本地全栈开发、云端生成迭代、创意设计UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用协…"
},
"en-US": {
"shortDesc": "妙搭Spark/Miaoda应用开发与托管应用创建、HTML静态站点发布、本地全栈开发、云端生成迭代。当用户要开发/新建一个系统·工具·平台·应用,或要本地开发 / 云端开发 / 修改 / 部署 / 发布 / 上线 / 拿可分享链接,或用 HTML 做页面·网站·部署到妙搭,或提到妙搭/Spark/Miaoda…"
"shortDesc": "妙搭Spark/Miaoda应用开发与托管应用创建、本地全栈开发、云端生成迭代、创意设计UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用协…"
}
}
},
@@ -74,13 +74,13 @@
{
"id": "lark-base",
"path": "skills/lark-base",
"version": "1.2.2",
"version": "1.2.21",
"i18n": {
"zh-CN": {
"shortDesc": "飞书多维表格Base操作建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、workflow、角色权限遇到 Base/多维表格/bitable 或 /base/ 链接时使用。文件导入转 lark-drive认证/授权转 lark-shared。"
"shortDesc": "飞书多维表格Base操作建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式BaseApp/AppMode 页面与组件、Workspace 目录、workflow、角色权限、模板中心多维表格模板分类/列表/搜索);遇到 Base/多维表格/bitable、BaseApp/AppMode、…"
},
"en-US": {
"shortDesc": "飞书多维表格Base操作建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、workflow、角色权限遇到 Base/多维表格/bitable 或 /base/ 链接时使用。文件导入转 lark-drive认证/授权转 lark-shared。"
"shortDesc": "飞书多维表格Base操作建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式BaseApp/AppMode 页面与组件、Workspace 目录、workflow、角色权限、模板中心多维表格模板分类/列表/搜索);遇到 Base/多维表格/bitable、BaseApp/AppMode、…"
}
}
},
@@ -90,10 +90,10 @@
"version": "1.0.0",
"i18n": {
"zh-CN": {
"shortDesc": "飞书日历:管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责:查询过去的视频会议记录(走 lark-vc)、待办任务(走 lark-task。"
"shortDesc": "飞书日历:管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责:查询过去的视频会议记录(走 lark-meeting)、待办任务(走 lark-task。"
},
"en-US": {
"shortDesc": "飞书日历:管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责:查询过去的视频会议记录(走 lark-vc)、待办任务(走 lark-task。"
"shortDesc": "飞书日历:管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责:查询过去的视频会议记录(走 lark-meeting)、待办任务(走 lark-task。"
}
}
},
@@ -103,23 +103,22 @@
"version": "1.0.0",
"i18n": {
"zh-CN": {
"shortDesc": "飞书 / Lark 通讯录:按姓名 / 邮箱解析成 open_id,或按 open_id 反查姓名 / 部门 / 邮箱 / 联系方式 / 个人状态 / 签名。当用户提到某人姓名要下一步发消息 / 排日程,或拿到 open_id 想查具体信息时使用。不负责部门树遍历、按部门列员工、组织架构图,这类需求走原生 OpenAP…"
"shortDesc": "飞书 / Lark 通讯录:按姓名 / 邮箱解析成 open_id,或按 open_id 反查姓名 / 部门 / 邮箱 / 联系方式 / 个人状态 / 签名,以及按关键词搜索当前用户可见的机器人 / 智能体(agent)。当用户提到一个名字要下一步发消息 / 排日程,或拿到 open_id 想查具体信息时使用。不负责部…"
},
"en-US": {
"shortDesc": "飞书 / Lark 通讯录:按姓名 / 邮箱解析成 open_id,或按 open_id 反查姓名 / 部门 / 邮箱 / 联系方式 / 个人状态 / 签名。当用户提到某人姓名要下一步发消息 / 排日程,或拿到 open_id 想查具体信息时使用。不负责部门树遍历、按部门列员工、组织架构图,这类需求走原生 OpenAP…"
"shortDesc": "飞书 / Lark 通讯录:按姓名 / 邮箱解析成 open_id,或按 open_id 反查姓名 / 部门 / 邮箱 / 联系方式 / 个人状态 / 签名,以及按关键词搜索当前用户可见的机器人 / 智能体(agent)。当用户提到一个名字要下一步发消息 / 排日程,或拿到 open_id 想查具体信息时使用。不负责部…"
}
}
},
{
"id": "lark-doc",
"path": "skills/lark-doc",
"version": "2.0.0",
"i18n": {
"zh-CN": {
"shortDesc": "飞书云文档Docx / Wiki 文档):读取和编辑飞书文档内容。当用户给出文档 URL 或 token或需要查看、创建、编辑文档插入或下载文档图片附件时使用。文档中嵌入的电子表格、多维表格、画板,先用本 skill 提取 token 再切到对应 skill。当用户给出 doubao.com 的 /docx/ 或…"
"shortDesc": "飞书云文档Docx / Wiki)内容操作:读取、创建、编辑文档插入或下载图片附件,以及操作思维笔记。用户提供文档 URL/token包括 doubao.com 的 /docx/、/wiki/)时使用;按 URL 路径/token 而非域名路由。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-d…"
},
"en-US": {
"shortDesc": "飞书云文档Docx / Wiki 文档):读取和编辑飞书文档内容。当用户给出文档 URL 或 token或需要查看、创建、编辑文档插入或下载文档图片附件时使用。文档中嵌入的电子表格、多维表格、画板,先用本 skill 提取 token 再切到对应 skill。当用户给出 doubao.com 的 /docx/ 或…"
"shortDesc": "飞书云文档Docx / Wiki)内容操作:读取、创建、编辑文档插入或下载图片附件,以及操作思维笔记。用户提供文档 URL/token包括 doubao.com 的 /docx/、/wiki/)时使用;按 URL 路径/token 而非域名路由。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-d…"
}
}
},
@@ -129,10 +128,10 @@
"version": "1.0.0",
"i18n": {
"zh-CN": {
"shortDesc": "飞书云空间(云盘/云存储):管理 Drive 文件和文件夹,包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token,或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/shee…"
"shortDesc": "飞书云空间(云盘/云存储):管理 Drive 文件和文件夹,包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签secure labels和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题,…"
},
"en-US": {
"shortDesc": "飞书云空间(云盘/云存储):管理 Drive 文件和文件夹,包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token,或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/shee…"
"shortDesc": "飞书云空间(云盘/云存储):管理 Drive 文件和文件夹,包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签secure labels和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题,…"
}
}
},
@@ -155,10 +154,10 @@
"version": "1.0.0",
"i18n": {
"zh-CN": {
"shortDesc": "飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件(支持大文件分片下载)、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片Interactive Card、监听卡片按钮回调card.action.trigger。当用户需要发消息、查看或搜索聊天记录、下载…"
"shortDesc": "飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片Interactive Card、监听卡片按钮回调card.action.trigger。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成…"
},
"en-US": {
"shortDesc": "飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件(支持大文件分片下载)、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片Interactive Card、监听卡片按钮回调card.action.trigger。当用户需要发消息、查看或搜索聊天记录、下载…"
"shortDesc": "飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片Interactive Card、监听卡片按钮回调card.action.trigger。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成…"
}
}
},
@@ -178,13 +177,26 @@
{
"id": "lark-markdown",
"path": "skills/lark-markdown",
"version": "1.2.1",
"version": "1.2.2",
"i18n": {
"zh-CN": {
"shortDesc": "飞书 Markdown查看、创建、上传、编辑和比较 Markdown 文件。当用户需要创建或编辑 Markdown 文件、读取、修改、局部 patch 或比较差异时使用。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。"
"shortDesc": "飞书 Markdown查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管"
},
"en-US": {
"shortDesc": "飞书 Markdown查看、创建、上传、编辑和比较 Markdown 文件。当用户需要创建或编辑 Markdown 文件、读取、修改、局部 patch 或比较差异时使用。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。"
"shortDesc": "飞书 Markdown查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管"
}
}
},
{
"id": "lark-meeting",
"path": "skills/lark-meeting",
"version": "1.0.0",
"i18n": {
"zh-CN": {
"shortDesc": "飞书视频会议:查询会议记录与会议产物(纪要/逐字稿/妙记)、妙记搜索/上传/下载/编辑、机器人参与会议;查询进行中的会议、实时会议内容(发言/聊天/共享文档)问答(会上/会里)、发送会中聊天/表情;基于 meeting_id、meeting_no、event_id、note_id、minute_token、vc-nod…"
},
"en-US": {
"shortDesc": "飞书视频会议:查询会议记录与会议产物(纪要/逐字稿/妙记)、妙记搜索/上传/下载/编辑、机器人参与会议;查询进行中的会议、实时会议内容(发言/聊天/共享文档)问答(会上/会里)、发送会中聊天/表情;基于 meeting_id、meeting_no、event_id、note_id、minute_token、vc-nod…"
}
}
},
@@ -194,10 +206,10 @@
"version": "1.0.0",
"i18n": {
"zh-CN": {
"shortDesc": "飞书妙记:搜索妙记、查看妙记基础信息、下载/上传音视频、读取或编辑妙记的产物内容、改标题、替换说话人/关键词。当给出minute_token、本地音视频文件要查/改/转妙记产物时使用;本地音视频转纪要/逐字稿优先走本 skill不要用 ffmpeg/whisper 本地转写。不负责:获取会议关联妙记,或仅按自然语言…"
"shortDesc": "仅当用户或上游配置显式指定 lark-minutes 时使用,相关请求统一交由 lark-meeting 技能处理。"
},
"en-US": {
"shortDesc": "飞书妙记:搜索妙记、查看妙记基础信息、下载/上传音视频、读取或编辑妙记的产物内容、改标题、替换说话人/关键词。当给出minute_token、本地音视频文件要查/改/转妙记产物时使用;本地音视频转纪要/逐字稿优先走本 skill不要用 ffmpeg/whisper 本地转写。不负责:获取会议关联妙记,或仅按自然语言…"
"shortDesc": "仅当用户或上游配置显式指定 lark-minutes 时使用,相关请求统一交由 lark-meeting 技能处理。"
}
}
},
@@ -207,10 +219,10 @@
"version": "1.0.0",
"i18n": {
"zh-CN": {
"shortDesc": "飞书会议纪要Note直查已知 note_id 时查询纪要详情、展示类型、关联文档 token并读取 unified 原始逐字记录。当用户已持有 note_id或从文档显式 vc-node-id 获得 note_id 时使用。不负责会议/日程/妙记定位、文档标题搜索或 Docx 正文读取。"
"shortDesc": "仅当用户或上游配置显式指定 lark-note 时使用,相关请求统一交由 lark-meeting 技能处理。"
},
"en-US": {
"shortDesc": "飞书会议纪要Note直查已知 note_id 时查询纪要详情、展示类型、关联文档 token并读取 unified 原始逐字记录。当用户已持有 note_id或从文档显式 vc-node-id 获得 note_id 时使用。不负责会议/日程/妙记定位、文档标题搜索或 Docx 正文读取。"
"shortDesc": "仅当用户或上游配置显式指定 lark-note 时使用,相关请求统一交由 lark-meeting 技能处理。"
}
}
},
@@ -243,26 +255,26 @@
{
"id": "lark-shared",
"path": "skills/lark-shared",
"version": "1.0.0",
"version": "1.1.0",
"i18n": {
"zh-CN": {
"shortDesc": "Use when first setting up lark-cli, running auth login, switching user/bot identity (--as), handling permission denied or scope errors, needing to update lark-c…"
"shortDesc": "Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing sco…"
},
"en-US": {
"shortDesc": "Use when first setting up lark-cli, running auth login, switching user/bot identity (--as), handling permission denied or scope errors, needing to update lark-c…"
"shortDesc": "Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing sco…"
}
}
},
{
"id": "lark-sheets",
"path": "skills/lark-sheets",
"version": "3.0.0",
"version": "3.1.8",
"i18n": {
"zh-CN": {
"shortDesc": "飞书电子表格:创建和操作电子表格。支持创建表格、管理工作表与行列结构(增删/合并/调整尺寸/隐藏/冻结)、读写单元格(值/公式/样式/批注/单元格图片)、查找替换、多操作原子批量更新,以及图表、透视表、条件格式、筛选器、迷你图、浮动图片等对象的创建与维护。当用户需要创建电子表格、管理工作表、批量读写或编辑数据、统计汇总…"
"shortDesc": "飞书电子表格:创建和操作电子表格。支持创建表格、管理工作表与行列结构(增删/合并/调整尺寸/隐藏/冻结)、读写单元格(值/公式/样式/批注/单元格图片)、查找替换、多操作批量更新,以及图表、透视表、条件格式、筛选器、迷你图、浮动图片等对象的创建与维护。当用户需要创建电子表格、管理工作表、批量读写或编辑数据、统计汇总与可…"
},
"en-US": {
"shortDesc": "飞书电子表格:创建和操作电子表格。支持创建表格、管理工作表与行列结构(增删/合并/调整尺寸/隐藏/冻结)、读写单元格(值/公式/样式/批注/单元格图片)、查找替换、多操作原子批量更新,以及图表、透视表、条件格式、筛选器、迷你图、浮动图片等对象的创建与维护。当用户需要创建电子表格、管理工作表、批量读写或编辑数据、统计汇总…"
"shortDesc": "飞书电子表格:创建和操作电子表格。支持创建表格、管理工作表与行列结构(增删/合并/调整尺寸/隐藏/冻结)、读写单元格(值/公式/样式/批注/单元格图片)、查找替换、多操作批量更新,以及图表、透视表、条件格式、筛选器、迷你图、浮动图片等对象的创建与维护。当用户需要创建电子表格、管理工作表、批量读写或编辑数据、统计汇总与可…"
}
}
},
@@ -311,10 +323,10 @@
"version": "1.0.0",
"i18n": {
"zh-CN": {
"shortDesc": "飞书视频会议:搜索历史会议记录、查询会议纪要(总结/待办/章节/逐字稿)、查询参会人快照。当用户查询已结束的会议、获取会议产物(纪要/妙记)、查看参会人时使用;查询未来日程走 lark-calendar。不负责Agent 真实入会/离会、会中实时事件(走 lark-vc-agent。"
"shortDesc": "仅当用户或上游配置显式指定 lark-vc 时使用,相关请求统一交由 lark-meeting 技能处理。"
},
"en-US": {
"shortDesc": "飞书视频会议:搜索历史会议记录、查询会议纪要(总结/待办/章节/逐字稿)、查询参会人快照。当用户查询已结束的会议、获取会议产物(纪要/妙记)、查看参会人时使用;查询未来日程走 lark-calendar。不负责Agent 真实入会/离会、会中实时事件(走 lark-vc-agent。"
"shortDesc": "仅当用户或上游配置显式指定 lark-vc 时使用,相关请求统一交由 lark-meeting 技能处理。"
}
}
},
@@ -324,10 +336,10 @@
"version": "1.0.0",
"i18n": {
"zh-CN": {
"shortDesc": "飞书视频会议会中能力:用于让应用机器人真实加入或离开正在进行的会议,并读取当前身份可见的会中事件,如参会人加入/离开、发言、聊天、屏幕共享。适用于用户询问正在开的会议发生了什么、谁在发言、是否共享内容,或需要发现当前可读的进行中会议 ID。不负责已结束会议搜索、参会人快照、纪要、逐字稿或录制查询这些使用 lark-v…"
"shortDesc": "仅当用户或上游配置显式指定 lark-vc-agent 时使用,相关请求统一交由 lark-meeting 技能处理。"
},
"en-US": {
"shortDesc": "飞书视频会议会中能力:用于让应用机器人真实加入或离开正在进行的会议,并读取当前身份可见的会中事件,如参会人加入/离开、发言、聊天、屏幕共享。适用于用户询问正在开的会议发生了什么、谁在发言、是否共享内容,或需要发现当前可读的进行中会议 ID。不负责已结束会议搜索、参会人快照、纪要、逐字稿或录制查询这些使用 lark-v…"
"shortDesc": "仅当用户或上游配置显式指定 lark-vc-agent 时使用,相关请求统一交由 lark-meeting 技能处理。"
}
}
},
@@ -347,7 +359,7 @@
{
"id": "lark-wiki",
"path": "skills/lark-wiki",
"version": "1.0.1",
"version": "1.0.3",
"i18n": {
"zh-CN": {
"shortDesc": "飞书知识库:管理知识空间、空间成员和文档节点。创建和查询知识空间、查看和管理空间成员、管理节点层级结构、在知识库中组织文档和快捷方式。当用户需要在知识库中查找或创建文档、浏览知识空间结构、查看或管理空间成员、移动或复制节点时使用。当用户给出 doubao.com 的 /wiki/ URL/token 时,也应直接使用本…"