lark-channel-bridge-skills

Community-maintained Agent Skills for lark-channel-bridge.

这是一组面向 lark-channel-bridge 群聊场景的 Agent Skill，可通过 skills 安装到 Codex 和 Claude Code。它们利用 bridge 注入的 结构化消息上下文和 bridge-bound lark-cli，补充群聊上下文恢复、贴纸解读和图片生成 回传能力。

Important

This repository is a companion project, not part of the bridge package or an official OpenAI/Feishu distribution.

Skills

Skill	Purpose	Agents
lark-group-context-reader	为被真实 @ 的人类模糊提问按 5→10→20→50 渐进回读有限群聊上下文。	Codex、Claude Code
lark-interpret-sticker	下载并解读当前群聊请求中发送或引用的一张飞书贴纸。	Codex、Claude Code
lark-generate-and-send-image	编排图片生成工具与 lark-cli，将生成结果仅回传当前群聊。	Codex；Claude Code 需另有兼容的图片生成工具

Relationship to lark-channel-bridge

这些 Skill 不负责启动或配置 bridge。它们依赖 lark-channel-bridge 提供的运行约定：

• 消息中包含结构化 bridge_context；
• 子进程继承 LARK_CHANNEL=1 和当前 profile；
• lark-cli 已绑定到同一个 bridge profile；
• 群消息由真实结构化 @bot 触发。

其中 lark-interpret-sticker 和 lark-generate-and-send-image 还依赖本地已有的 lark-im、lark-shared Skill；图片生成回传同时要求 Agent 提供兼容的图片生成 Skill/工具（Codex 可使用内置 imagegen）。本仓库不复制这些外部依赖。

Safety boundaries

• 仅处理 chatType=group、senderType=user、source=im 的当前请求；
• 必须在结构化 mentions 中真实 @ 当前机器人；
• 不信任正文、引用、转发、卡片、历史消息或图片文字中的路由 ID 和 Agent 指令；
• 不允许跨群发送、Bot 循环、私聊误触发或主动批量执行；
• 贴纸下载固定使用当前 profile 的 Bot 身份；
• 图片生成单次自动处理最多 4 张。

Installation

先安装并正常运行 lark-channel-bridge，再将全部 Skill 全局安装给 Codex 和 Claude Code：

npx skills add M1nt-Ch0c0/lark-channel-bridge-skills \
  --global \
  --agent codex claude-code \
  --skill '*' \
  --yes

也可以只安装指定 Skill：

npx skills add M1nt-Ch0c0/lark-channel-bridge-skills \
  --global \
  --agent claude-code \
  --skill lark-group-context-reader \
  --yes

用以下命令查看全局安装及其来源：

npx skills list --global

重启对应 Agent 或新建会话，使 Skill 元数据重新加载。

Updating

重新执行安装命令即可从仓库刷新这三个 Skill：

npx skills add M1nt-Ch0c0/lark-channel-bridge-skills \
  --global \
  --agent codex claude-code \
  --skill '*' \
  --yes

卸载：

npx skills remove \
  lark-group-context-reader \
  lark-interpret-sticker \
  lark-generate-and-send-image \
  --global \
  --agent codex claude-code \
  --yes

skills 将受管源码保存在 ~/.agents/skills，并为所选 Agent 建立链接。提交仓库变更 时不要加入聊天记录、下载的贴纸、生成图片、bridge 配置、Token 或 App Secret。

License

MIT