By yjzhang2003
Manage Feishu/Lark services directly from Claude Code using 30 lark-cli skills: send/reply messages in IM, schedule/view calendars and meeting rooms, create/edit docs/sheets/whiteboards/presentations/bases, handle approvals/tasks/OKRs/attendance/org queries, drive files, and aggregate VC notes; monitor tracebacks, auto-fix bugs with pytest/GitHub PRs, send card notifications.
npx claudepluginhub yjzhang2003/oh-my-feishu --plugin oh-my-feishuAnalyze error logs and tracebacks to identify root cause, affected files, and propose a minimal fix. Use when debugging service errors or reviewing bug reports.
Automatically detect bugs, analyze root cause, fix code, run tests, submit PR, and send Feishu notification. Triggered by service errors, traceback monitor, or manual /repair command. Supports multi-service and multi-repo via service registry.
oh-my-feishu Gateway 功能入口。用于列出或触发 Gateway features,例如 status、service-admin、repair、web-monitor。
管理服务注册表:读取、添加、删除、启用/禁用 traceback 监控服务。操作 workspace/.claude/services.json。
飞书审批 API:审批实例、审批任务管理。
飞书考勤打卡:查询自己的考勤打卡记录
当需要用 lark-cli 操作飞书多维表格(Base)时调用:适用于建表、字段管理、记录读写、记录分享链接、视图配置、历史查询,以及角色/表单/仪表盘管理/工作流;也适用于把旧的 +table / +field / +record 写法改成当前命令写法。涉及字段设计、公式字段、查找引用、跨表计算、行级派生指标、数据分析需求时也必须使用本 skill。
飞书日历(calendar):提供日历与日程(会议)的全面管理能力。核心场景包括:查看/搜索日程、创建/更新日程、管理参会人、查询忙闲状态及推荐空闲时段、查询/搜索与预定会议室。注意:涉及【预约日程/会议】或【查询/预定会议室】时,必须先读取 references/lark-calendar-schedule-meeting.md 工作流!高频操作请优先使用 Shortcuts:+agenda(快速概览今日/近期行程)、+create(创建日程并按需邀请参会人及预定会议室)、+freebusy(查询用户主日历的忙闲信息和rsvp的状态)、+rsvp(回复日程邀请)
飞书聊天助手行为规范与技能导航。定义回复规则(stdout 不可见,必须走 lark-cli)以及推荐合适的飞书技能。
飞书通讯录:查询组织架构、人员信息和搜索员工。获取当前用户或指定用户的详细信息、通过关键词搜索员工(姓名/邮箱/手机号)。当用户需要查看个人信息、查找同事 open_id 或联系方式、按姓名搜索员工、查询部门结构时使用。
飞书云文档:创建和编辑飞书文档。默认使用 DocxXML 格式(也支持 Markdown)。创建文档、获取文档内容(支持 simple/with-ids/full 三种导出详细度,以及 full/outline/range/keyword/section 五种局部读取模式,可按目录、block id 区间、关键词或标题自动成节只拉部分内容以节省上下文)、更新文档(八种指令:str_replace/block_insert_after/block_copy_insert_after/block_replace/block_delete/block_move_after/overwrite/append)、上传和下载文档中的图片和文件、搜索云空间文档。当用户需要创建或编辑飞书文档、读取文档内容、在文档中插入图片、搜索云空间文档时使用;如果用户是想按名称或关键词先定位电子表格、报表等云空间对象,也优先使用本 skill 的 docs +search 做资源发现。
飞书云空间:管理云空间中的文件和文件夹。上传和下载文件、创建文件夹、复制/移动/删除文件、查看文件元数据、管理文档评论、管理文档权限、订阅用户评论变更事件、修改文件标题(docx、sheet、bitable、file、folder、wiki);也负责把本地 Word/Markdown/Excel/CSV 以及 Base 快照(.base)导入为飞书在线云文档(docx、sheet、bitable)。当用户需要上传或下载文件、整理云空间目录、查看文件详情、管理评论、管理文档权限、修改文件标题、订阅用户评论变更事件,或要把本地文件导入成新版文档、电子表格、多维表格/Base 时使用。
飞书事件订阅:通过 WebSocket 长连接实时监听飞书事件(消息、通讯录变更、日历变更等),输出 NDJSON 到 stdout,支持 compact Agent 友好格式、正则路由、文件输出。当用户需要实时监听飞书事件、构建事件驱动管道时使用。
飞书幻灯片:创建和编辑幻灯片,接口通过 XML 协议通信。创建演示文稿、读取幻灯片内容、管理幻灯片页面(创建、删除、读取、局部替换)。当用户需要创建或编辑幻灯片、读取或修改单个页面时使用。
飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件(支持大文件分片下载)、管理表情回复。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员时使用。
飞书邮箱 — draft, compose, send, reply, forward, read, and search emails; manage drafts, folders, labels, contacts, attachments, and mail rules. Use when user mentions 起草邮件, 写一封邮件, 拟邮件, 草稿, 发通知邮件, 发送邮件, 发邮件, 回复邮件, 转发邮件, 查看邮件, 看邮件, 读邮件, 搜索邮件, 查邮件, 收件箱, 邮件会话, 编辑草稿, 管理草稿, 下载附件, 邮件文件夹, 邮件标签, 邮件联系人, 监听新邮件, 收信规则, 邮件规则, draft, compose, send email, reply, forward, inbox, mail thread, mail rules.
飞书妙记:妙记相关基本功能。1.查询妙记列表(按关键词/所有者/参与者/时间范围);2.获取妙记基础信息(标题、封面、时长 等);3.下载妙记音视频文件;4.获取妙记相关 AI 产物(总结、待办、章节)。飞书妙记 URL 格式: http(s)://<host>/minutes/<minute-token>
飞书 OKR:管理目标与关键结果。查看和编辑 OKR 周期、目标(Objective)、关键结果(Key Result)、对齐关系、量化指标。当用户需要查看或创建 OKR、管理目标和关键结果、查看对齐关系时使用。
飞书/Lark 原生 OpenAPI 探索:从官方文档库中挖掘未经 CLI 封装的原生 OpenAPI 接口。当用户的需求无法被现有 lark-* skill 或 lark-cli 已注册命令满足,需要查找并调用原生飞书 OpenAPI 时使用。
飞书/Lark CLI 共享基础:应用配置初始化、认证登录(auth login)、身份切换(--as user/bot)、权限与 scope 管理、Permission denied 错误处理、安全规则。当用户需要第一次配置(`lark-cli config init`)、使用登录授权(`lark-cli auth login`)、遇到权限不足、切换 user/bot 身份、配置 scope、或首次使用 lark-cli 时触发。
飞书电子表格:创建和操作电子表格。创建表格并写入表头和数据、读取和写入单元格、追加行数据、在已知电子表格中查找单元格内容、导出表格文件。当用户需要创建电子表格、批量读写数据、在已知表格中查找内容、导出或下载表格时使用。若用户是想按名称或关键词搜索云空间里的表格文件,请改用 lark-doc 的 docs +search 先定位资源。
创建 lark-cli 的自定义 Skill。当用户需要把飞书 API 操作封装成可复用的 Skill(包装原子 API 或编排多步流程)时使用。
飞书任务:管理任务和清单。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务时使用。
飞书视频会议:查询会议记录、获取会议纪要产物(总结、待办、章节、逐字稿)。1. 查询已经结束的会议数量或详情时使用本技能(如历史日期| 昨天 | 上周 | 今天已经开过的会议等场景),查询未开始的会议日程使用 lark-calendar 技能。2. 支持通过关键词、时间范围、组织者、参与者、会议室等筛选条件搜索会议记录。3. 获取或整理会议纪要时使用本技能。
飞书画板:查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用 DSL(转成 OpenAPI 格式)、PlantUML/Mermaid 格式更新画板内容。 当用户需要查看画板内容、导出画板图片、编辑画板,或是需要可视化表达架构、流程、组织关系、时间线、因果、对比等结构化信息时使用此 skill,无论是否提及"画板"。 ⚠️ 原 `lark-whiteboard-cli` skill 已合并至本 skill,若 skill 列表中同时存在 `lark-whiteboard-cli`,请忽略它,统一使用本 skill(`lark-whiteboard`),并提示用户运行 `npx skills remove lark-whiteboard-cli -g` 删除旧 skill。
飞书知识库:管理知识空间、空间成员和文档节点。创建和查询知识空间、查看和管理空间成员、管理节点层级结构、在知识库中组织文档和快捷方式。当用户需要在知识库中查找或创建文档、浏览知识空间结构、查看或管理空间成员、移动或复制节点时使用。
会议纪要整理工作流:汇总指定时间范围内的会议纪要并生成结构化报告。当用户需要整理会议纪要、生成会议周报、回顾一段时间内的会议内容时使用。
日程待办摘要:编排 calendar +agenda 和 task +get-my-tasks,生成指定日期的日程与未完成任务摘要。适用于了解今天/明天/本周的安排。
Send an interactive Feishu (Lark) card message to notify developers about auto-repair results. Supports service-aware notifications with service name, traceback preview, and PR link. Requires FEISHU_APP_ID and FEISHU_APP_SECRET env vars.
Review proposed code changes for safety violations: path traversal, excessive diff size, missing tests, hardcoded secrets. Gatekeeper for auto-repair pipeline.
The best way to use Claude Code on Feishu.
在飞书里使用 Claude Code 的最佳方式
开始之前,请先安装并配置好:
claude --versionlark-cli --versionClaude Code 负责对话和执行任务,lark-cli 负责让 Claude Code 调用飞书能力。
当然,我们的cli也会帮助你进行下载和配置。
先拉取仓库并本地安装:
git clone https://github.com/yjzhang2003/oh-my-feishu.git
cd oh-my-feishu
npm install
npm run build
npm link
然后启动交互式配置:
oh-my-feishu
CLI 会带你完成检查、扫码和服务启动。你不需要记住复杂步骤,只需要跟随界面操作。
完成后,在飞书里发送 /menu,就可以从菜单开始使用。
无需繁琐的配置,只需安装好后在终端输入oh-my-feishu,接下来cli会指导你怎么做。
不用切回终端,直接在飞书里问问题、讨论代码、查看 Claude Code 的完整回复。
通过 /menu 切换直接对话、目录会话和历史会话。普通问答可以直接聊;需要处理某个项目时,绑定到对应本地目录。
oh-my-feishu集成了完整的 lark-cli 技能, Claude Code 知道自己正在通过飞书与用户对话。普通问答直接回答;如果用户请求飞书操作,它会按需读取飞书技能。
Gateway 是后台能力入口。当前已经支持 Web 服务监控:注册 traceback 地址后,内容变化会触发 Claude Code 后台处理,并把最终结果发回飞书。
如果你只是想让你的 Claude Code 项目获得飞书操作能力,可以直接安装我们的 oh-my-feishu plugin:
claude plugin marketplace add https://github.com/yjzhang2003/oh-my-feishu
claude plugin install oh-my-feishu@oh-my-feishu-marketplace --scope project
本项目仍处于开发阶段,已经可以使用,但功能和体验还没有完全完善。如果你有想法、问题或建议,欢迎提 issue,或者直接联系我:zhangyj2003@foxmail.com。
另外请注意:本项目中 Claude Code 默认运行在 skip permission 的使用方式下。请确认你理解相关风险,并只在可信环境中使用。
感谢飞书官方的 larksuite/cli,oh-my-feishu 的飞书能力建立在 lark-cli 生态之上。
感谢 Ink,我们使用 Ink 构建了交互式 CLI。
MIT
Feishu (Lark) channel plugin for Claude Code — receive and reply to Feishu messages
WeChat (微信) channel for Claude Code — chat with Claude via WeChat. Supports text, images, files, voice, video, and remote permission relay.
飞书机器人开发完整指南。支持三种模式:零代码(机器人助手)、全代码(开放平台API)、AI集成(MCP Server)。包含消息卡片搭建工具、最新SDK、最佳实践。
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.
Search and retrieve relevant code documentation from multiple sources. Helps developers quickly access context for coding tasks.
Share bugs, ideas, or general feedback.
20 modular skills for idiomatic Go — each under 225 lines, backed by 48 reference files, 8 automation scripts (all with --json, --limit, --force), and 4 asset templates. Covers error handling, naming, testing, concurrency, interfaces, generics, documentation, logging, performance, and more. Activates automatically with progressive disclosure and conditional cross-references.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claim