refactor(lark): move rebuild script out of plugin, env-agnostic banner, README skills list

- move plugins/lark/rebuild.py to scripts/lark-rebuild.py so the
  maintenance script is no longer distributed with the plugin
- drop its duplicate marketplace.json writer; delegate propagation to
  scripts/sync-plugins.sh (single sync entry point), add --version /
  auto patch-bump, print precise git add paths instead of 'git add -A'
- banner: replace hardcoded /opt/homebrew/bin guidance with
  'command -v lark-cli' / npm-prefix wording across all 27 SKILL.md
- README: expand with generated skills list (marker-driven, kept in
  sync by the rebuild script)
- fix 3 broken cross-skill references

Author: DropFan

plugins/lark/README.md

@@ -1,6 +1,68 @@
-# lark (Cowork)
+# lark
 
-Feishu/Lark skills bundled for Cowork, driven by local `lark-cli` (`@larksuite/cli`).
+Feishu/Lark skills for Claude Code and Cowork, driven by the local `lark-cli` (`@larksuite/cli`). Mirrors the upstream lark-cli skill set: IM, Docs, Base, Sheets, Calendar, Drive, Wiki, Task, OKR, VC, Mail, and more — see the full list below.
 
-Prereq: `npm i -g @larksuite/cli`, then `lark-cli config init` and `lark-cli auth login`.
-In Cowork, run lark-cli on the local Mac (Desktop Commander), not the Linux sandbox.
+## Installation
+
+1. Install and authenticate the CLI:
+
+   ```bash
+   npm i -g @larksuite/cli
+   lark-cli config init
+   lark-cli auth login
+   ```
+
+2. Install the plugin from this marketplace (inside Claude Code):
+
+   ```
+   /plugin marketplace add DropFan/claude-code-plugins
+   /plugin install lark@tiger-plugins
+   ```
+
+In Cowork, run lark-cli on the local Mac (e.g. via Desktop Commander), not the Linux sandbox — each SKILL.md carries an auto-injected note with details.
+
+## Skills
+
+<!-- SKILLS_LIST_START -->
+| Skill | Description |
+| --- | --- |
+| [lark-approval](skills/lark-approval/SKILL.md) | 飞书审批：查询和处理审批待办/已办/实例，搜索可发起审批定义、查看定义详情并发起原生审批实例。 |
+| [lark-apps](skills/lark-apps/SKILL.md) | 妙搭（Spark/Miaoda）应用开发与托管：应用创建、HTML静态站点发布、本地全栈开发、云端生成迭代。 |
+| [lark-attendance](skills/lark-attendance/SKILL.md) | 飞书考勤打卡：查询自己的考勤打卡记录 |
+| [lark-base](skills/lark-base/SKILL.md) | 飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、workflow、角色权限；遇到 Base/多维表格/bitable 或 /base/ 链接时使用。 |
+| [lark-calendar](skills/lark-calendar/SKILL.md) | 飞书日历：管理日历日程和会议室。 |
+| [lark-contact](skills/lark-contact/SKILL.md) | 飞书 / Lark 通讯录:按姓名 / 邮箱解析成 open_id,或按 open_id 反查姓名 / 部门 / 邮箱 / 联系方式 / 个人状态 / 签名。 |
+| [lark-doc](skills/lark-doc/SKILL.md) | 飞书云文档（Docx / Wiki 文档）：读取和编辑飞书文档内容。 |
+| [lark-drive](skills/lark-drive/SKILL.md) | 飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本和本地文件导入。 |
+| [lark-event](skills/lark-event/SKILL.md) | Lark/Feishu real-time event listening / subscribing / consuming: stream events as NDJSON via `lark-cli event consume <EventKey>` (covers IM messages/reactions/chat changes, Task updates, VC meeting started/joined/ended, Minutes generated, Whiteboard updated, etc.). |
+| [lark-im](skills/lark-im/SKILL.md) | 飞书即时通讯：收发消息和管理群聊。 |
+| [lark-mail](skills/lark-mail/SKILL.md) | 飞书邮箱：Use when user mentions 起草邮件、写邮件、草稿、发送/回复/转发邮件、查阅邮件、看邮件、搜索邮件、邮件文件夹、邮件标签、邮件联系人、监听新邮件、邮件收信规则等；use for mail/email intent only. |
+| [lark-markdown](skills/lark-markdown/SKILL.md) | 飞书 Markdown：查看、创建、上传、编辑和比较 Markdown 文件。 |
+| [lark-minutes](skills/lark-minutes/SKILL.md) | 飞书妙记：搜索妙记、查看妙记基础信息、下载/上传音视频、读取或编辑妙记的产物内容、改标题、替换说话人/关键词。 |
+| [lark-note](skills/lark-note/SKILL.md) | 飞书会议纪要（Note）直查：已知 note_id 时查询纪要详情、展示类型、关联文档 token，并读取 unified 原始逐字记录。 |
+| [lark-okr](skills/lark-okr/SKILL.md) | 飞书 OKR：管理目标与关键结果。 |
+| [lark-openapi-explorer](skills/lark-openapi-explorer/SKILL.md) | 飞书/Lark 原生 OpenAPI 探索：从官方文档库中挖掘未经 CLI 封装的原生 OpenAPI 接口。 |
+| [lark-shared](skills/lark-shared/SKILL.md) | Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling _notice JSON. |
+| [lark-sheets](skills/lark-sheets/SKILL.md) | 飞书电子表格：创建和操作电子表格。 |
+| [lark-skill-maker](skills/lark-skill-maker/SKILL.md) | 创建 lark-cli 的自定义 Skill。 |
+| [lark-slides](skills/lark-slides/SKILL.md) | 飞书幻灯片：创建和编辑幻灯片。 |
+| [lark-task](skills/lark-task/SKILL.md) | 飞书任务：管理任务、清单和任务智能体。 |
+| [lark-vc](skills/lark-vc/SKILL.md) | 飞书视频会议：搜索历史会议记录、查询会议纪要（总结/待办/章节/逐字稿）、查询参会人快照。 |
+| [lark-vc-agent](skills/lark-vc-agent/SKILL.md) | 飞书视频会议会中能力：用于让应用机器人真实加入或离开正在进行的会议，并读取当前身份可见的会中事件，如参会人加入/离开、发言、聊天、屏幕共享。 |
+| [lark-whiteboard](skills/lark-whiteboard/SKILL.md) | 飞书画板：查询和编辑飞书云文档中的画板。 |
+| [lark-wiki](skills/lark-wiki/SKILL.md) | 飞书知识库：管理知识空间、空间成员和文档节点。 |
+| [lark-workflow-meeting-summary](skills/lark-workflow-meeting-summary/SKILL.md) | 会议纪要整理工作流：汇总指定时间范围内的会议纪要并生成结构化报告。 |
+| [lark-workflow-standup-report](skills/lark-workflow-standup-report/SKILL.md) | 日程待办摘要：编排 calendar +agenda 和 task +get-my-tasks，生成指定日期的日程与未完成任务摘要。 |
+<!-- SKILLS_LIST_END -->
+
+## Syncing with upstream
+
+Skill content is copied verbatim from the upstream `larksuite/cli` skills by `scripts/lark-rebuild.py` (in the repository root, not shipped with the plugin):
+
+1. `npx skills add larksuite/cli -g -y` — refresh the upstream skills in `~/.agents/skills`
+2. `python3 scripts/lark-rebuild.py [--version X.Y.Z]` — re-copy the skills, inject the Cowork note, regenerate the table above, update the plugin version, and run `scripts/sync-plugins.sh` to propagate the metadata to `marketplace.json` and the root README
+3. `git add plugins/lark .claude-plugin/marketplace.json README.md`, then commit
+
+By convention the plugin version follows the `@larksuite/cli` release it was synced from — pass `--version` to keep them aligned; without it the patch version is bumped by one.
+
+Note: local edits to files under `skills/` are overwritten by the next rebuild; fixes that must persist belong in the upstream repository.

plugins/lark/rebuild.py

@@ -11,10 +11,10 @@ metadata:
 <!-- cowork-exec-note -->
 > **⚙️ Cowork / Claude Desktop 执行环境说明（自动注入）**
 >
-> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，位于 `/opt/homebrew/bin/lark-cli`）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
+> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，可用 `command -v lark-cli` 定位）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
 >
 > 在 Cowork 中运行任何 `lark-cli` 命令时，**必须在本地 macOS 上执行**（使用 Desktop Commander 的 `start_process` / `interact_with_process`，或其它本地 shell 工具），**不要用隔离的 Linux 沙箱** `mcp__workspace__bash`——沙箱里没有 lark-cli、也读不到 keychain。
-> 执行前确保 PATH 含 Homebrew：`export PATH="/opt/homebrew/bin:$PATH"`。
+> 执行前确保 npm 全局 bin 目录（`npm prefix -g` 输出目录下的 `bin`）在 PATH 中。
 >
 > （在 Claude Code 中可忽略本说明，lark-cli 在本机 shell 直接可用。）
 

plugins/lark/skills/lark-approval/SKILL.md

@@ -11,10 +11,10 @@ metadata:
 <!-- cowork-exec-note -->
 > **⚙️ Cowork / Claude Desktop 执行环境说明（自动注入）**
 >
-> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，位于 `/opt/homebrew/bin/lark-cli`）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
+> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，可用 `command -v lark-cli` 定位）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
 >
 > 在 Cowork 中运行任何 `lark-cli` 命令时，**必须在本地 macOS 上执行**（使用 Desktop Commander 的 `start_process` / `interact_with_process`，或其它本地 shell 工具），**不要用隔离的 Linux 沙箱** `mcp__workspace__bash`——沙箱里没有 lark-cli、也读不到 keychain。
-> 执行前确保 PATH 含 Homebrew：`export PATH="/opt/homebrew/bin:$PATH"`。
+> 执行前确保 npm 全局 bin 目录（`npm prefix -g` 输出目录下的 `bin`）在 PATH 中。
 >
 > （在 Claude Code 中可忽略本说明，lark-cli 在本机 shell 直接可用。）
 

plugins/lark/skills/lark-apps/SKILL.md

@@ -11,10 +11,10 @@ metadata:
 <!-- cowork-exec-note -->
 > **⚙️ Cowork / Claude Desktop 执行环境说明（自动注入）**
 >
-> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，位于 `/opt/homebrew/bin/lark-cli`）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
+> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，可用 `command -v lark-cli` 定位）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
 >
 > 在 Cowork 中运行任何 `lark-cli` 命令时，**必须在本地 macOS 上执行**（使用 Desktop Commander 的 `start_process` / `interact_with_process`，或其它本地 shell 工具），**不要用隔离的 Linux 沙箱** `mcp__workspace__bash`——沙箱里没有 lark-cli、也读不到 keychain。
-> 执行前确保 PATH 含 Homebrew：`export PATH="/opt/homebrew/bin:$PATH"`。
+> 执行前确保 npm 全局 bin 目录（`npm prefix -g` 输出目录下的 `bin`）在 PATH 中。
 >
 > （在 Claude Code 中可忽略本说明，lark-cli 在本机 shell 直接可用。）
 

plugins/lark/skills/lark-attendance/SKILL.md

@@ -11,10 +11,10 @@ metadata:
 <!-- cowork-exec-note -->
 > **⚙️ Cowork / Claude Desktop 执行环境说明（自动注入）**
 >
-> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，位于 `/opt/homebrew/bin/lark-cli`）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
+> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，可用 `command -v lark-cli` 定位）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
 >
 > 在 Cowork 中运行任何 `lark-cli` 命令时，**必须在本地 macOS 上执行**（使用 Desktop Commander 的 `start_process` / `interact_with_process`，或其它本地 shell 工具），**不要用隔离的 Linux 沙箱** `mcp__workspace__bash`——沙箱里没有 lark-cli、也读不到 keychain。
-> 执行前确保 PATH 含 Homebrew：`export PATH="/opt/homebrew/bin:$PATH"`。
+> 执行前确保 npm 全局 bin 目录（`npm prefix -g` 输出目录下的 `bin`）在 PATH 中。
 >
 > （在 Claude Code 中可忽略本说明，lark-cli 在本机 shell 直接可用。）
 

plugins/lark/skills/lark-base/SKILL.md

@@ -11,10 +11,10 @@ metadata:
 <!-- cowork-exec-note -->
 > **⚙️ Cowork / Claude Desktop 执行环境说明（自动注入）**
 >
-> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，位于 `/opt/homebrew/bin/lark-cli`）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
+> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，可用 `command -v lark-cli` 定位）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
 >
 > 在 Cowork 中运行任何 `lark-cli` 命令时，**必须在本地 macOS 上执行**（使用 Desktop Commander 的 `start_process` / `interact_with_process`，或其它本地 shell 工具），**不要用隔离的 Linux 沙箱** `mcp__workspace__bash`——沙箱里没有 lark-cli、也读不到 keychain。
-> 执行前确保 PATH 含 Homebrew：`export PATH="/opt/homebrew/bin:$PATH"`。
+> 执行前确保 npm 全局 bin 目录（`npm prefix -g` 输出目录下的 `bin`）在 PATH 中。
 >
 > （在 Claude Code 中可忽略本说明，lark-cli 在本机 shell 直接可用。）
 

plugins/lark/skills/lark-calendar/SKILL.md

@@ -11,10 +11,10 @@ metadata:
 <!-- cowork-exec-note -->
 > **⚙️ Cowork / Claude Desktop 执行环境说明（自动注入）**
 >
-> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，位于 `/opt/homebrew/bin/lark-cli`）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
+> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，可用 `command -v lark-cli` 定位）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
 >
 > 在 Cowork 中运行任何 `lark-cli` 命令时，**必须在本地 macOS 上执行**（使用 Desktop Commander 的 `start_process` / `interact_with_process`，或其它本地 shell 工具），**不要用隔离的 Linux 沙箱** `mcp__workspace__bash`——沙箱里没有 lark-cli、也读不到 keychain。
-> 执行前确保 PATH 含 Homebrew：`export PATH="/opt/homebrew/bin:$PATH"`。
+> 执行前确保 npm 全局 bin 目录（`npm prefix -g` 输出目录下的 `bin`）在 PATH 中。
 >
 > （在 Claude Code 中可忽略本说明，lark-cli 在本机 shell 直接可用。）
 

plugins/lark/skills/lark-contact/SKILL.md

@@ -11,10 +11,10 @@ metadata:
 <!-- cowork-exec-note -->
 > **⚙️ Cowork / Claude Desktop 执行环境说明（自动注入）**
 >
-> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，位于 `/opt/homebrew/bin/lark-cli`）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
+> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，可用 `command -v lark-cli` 定位）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
 >
 > 在 Cowork 中运行任何 `lark-cli` 命令时，**必须在本地 macOS 上执行**（使用 Desktop Commander 的 `start_process` / `interact_with_process`，或其它本地 shell 工具），**不要用隔离的 Linux 沙箱** `mcp__workspace__bash`——沙箱里没有 lark-cli、也读不到 keychain。
-> 执行前确保 PATH 含 Homebrew：`export PATH="/opt/homebrew/bin:$PATH"`。
+> 执行前确保 npm 全局 bin 目录（`npm prefix -g` 输出目录下的 `bin`）在 PATH 中。
 >
 > （在 Claude Code 中可忽略本说明，lark-cli 在本机 shell 直接可用。）
 

plugins/lark/skills/lark-doc/SKILL.md

@@ -11,10 +11,10 @@ metadata:
 <!-- cowork-exec-note -->
 > **⚙️ Cowork / Claude Desktop 执行环境说明（自动注入）**
 >
-> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，位于 `/opt/homebrew/bin/lark-cli`）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
+> 本技能依赖本地 `lark-cli`（`@larksuite/cli`，可用 `command -v lark-cli` 定位）及其 `~/.lark-cli` 登录态（应用密钥存于 macOS keychain）。
 >
 > 在 Cowork 中运行任何 `lark-cli` 命令时，**必须在本地 macOS 上执行**（使用 Desktop Commander 的 `start_process` / `interact_with_process`，或其它本地 shell 工具），**不要用隔离的 Linux 沙箱** `mcp__workspace__bash`——沙箱里没有 lark-cli、也读不到 keychain。
-> 执行前确保 PATH 含 Homebrew：`export PATH="/opt/homebrew/bin:$PATH"`。
+> 执行前确保 npm 全局 bin 目录（`npm prefix -g` 输出目录下的 `bin`）在 PATH 中。
 >
 > （在 Claude Code 中可忽略本说明，lark-cli 在本机 shell 直接可用。）