飞书聊天助手的入口规则。它判断用户是在普通问答,还是需要调用飞书能力,并把任务路由到对应 lark skill。
Claude Plugin
把飞书能力安装进 Claude Code
oh-my-feishu 不只是主应用,也可以作为 Claude Code plugin 安装到任意项目。安装后,Claude Code 能按需读取飞书 skills,用 lark-cli 操作消息、文档、日程、表格、任务、云盘和 Gateway 自动化能力。
Install from marketplace
claude plugin marketplace add https://github.com/yjzhang2003/oh-my-feishu
claude plugin install oh-my-feishu@oh-my-feishu-marketplace --scope project Core skills
三个入口 skill 决定 Claude 怎么行动
这些不是 API 清单,而是给 Claude Code 的行为规则:什么时候回答、什么时候调用工具、什么时候进入后台自动化。
所有飞书 skill 的公共约束,集中说明认证、权限、身份选择、安全边界和通用参数。
oh-my-feishu Gateway 的技能入口,用于查询或触发后台 feature,例如 status、service-admin、repair、web-monitor。
Lark domains
飞书业务域 skills
项目把飞书能力拆成多个业务域。Claude 不需要一次性记住所有 API,而是在用户请求进入某个场景时读取对应 skill。
即时通讯:发消息、回复、搜索聊天、管理群成员、处理聊天中的图片和文件。
云文档:创建、读取、局部拉取、编辑、插入图片和搜索云空间文档。
电子表格:读写单元格、管理工作表、处理表格数据。
多维表格:表、字段、记录、视图、仪表盘、表单和数据分析。
日历日程:创建会议、查日程、查忙闲、管理参会人和会议室。
云盘:上传下载、导入本地文件、管理文件夹、权限、评论和标题。
任务:创建任务、查看任务列表、管理任务状态。
知识库:空间、成员、节点层级和知识库文档组织。
视频会议与妙记:查询会议记录、获取会议纪要、下载转录内容。
邮箱:起草、发送、回复、转发、搜索邮件和管理草稿。
画板和幻灯片:可视化表达结构、生成演示内容。
组合工作流:会议纪要汇总、日程待办摘要等跨域任务。
Web Monitor skills
自动化服务的专用 skills
Web Monitor 不是简单让 AI 自由改代码,而是把服务管理、只读分析、自动修复、安全检查和结果通知拆成清晰的协议。
通过 oh-my-feishu web-monitor CLI 管理监控服务,不直接编辑 services.json。
只读分析 traceback,给出根因和修复计划,等待用户确认。
在目标仓库内执行最小修复、运行验证,并把最终结果交回 Gateway。
检查路径越界、diff 规模、测试缺失和敏感信息。
在需要时发送飞书通知卡片,正常情况下由 Gateway 统一发布结果。
解析日志和 traceback,定位异常类型、调用栈、影响文件和最小修复方向。
web-monitor-auto-repair
自动修复不是放任 AI 改代码
这个 skill 把 traceback 修复拆成可审计的后台协议:先确认上下文,再分析根因,最后用最小 diff 修复并验证。
输入从哪里来
Gateway 触发时传入服务名、GitHub 仓库、traceback URL、本地仓库路径和 PR 配置。
SERVICE_NAME、TARGET_REPO_PATH、TRACEBACK_URL、WEB_MONITOR_AUTO_PR 等作为兜底输入。
必要时读取 .claude/triggers/latest.json 或 workspace/.claude/triggers/latest.json。
执行顺序
确认服务、目标仓库、错误类型和受影响文件。
读取 traceback URL、日志文件或内联错误文本。
定位根因,判断最小修复点。
生成聚焦、可解释的最小变更。
检查路径、diff 规模、密钥和测试要求。
应用改动并运行最相关验证命令。
保留本地修复,按配置决定是否创建 PR,并把结果交回 Gateway。
安全边界
只能修改 TARGET_REPO_PATH / localRepoPath 内的文件。
超过 10 个文件或 500 行时停止,要求人工介入。
修改后必须运行可发现的最相关验证命令。
不能写入 token、password、secret、api_key 等敏感信息。
除非 WEB_MONITOR_AUTO_PR=true,否则不 push、不创建 PR。