cso1z

Feishu Skill — AI skill for Claude Code

AI community

赋予 AI 直接操作飞书(Feishu / Lark)的能力——创建和编辑飞书文档与块内容、管理任务与文件夹、查询用户信息,让飞书文档协作无缝融入 AI 编码工作流.

How to install Feishu Skill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open cso1z/Feishu-Skill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Feishu Skill does

赋予 AI 直接操作飞书(Feishu / Lark)的能力——创建和编辑飞书文档与块内容、管理任务与文件夹、查询用户信息,让飞书文档协作无缝融入 AI 编码工作流.

Alternatives in AI

  • Claude To Im Skill — Bridge Claude Code / Codex to IM platforms — chat with AI coding agents from Telegram, Discord, or Feishu/Lark 1.3k ★
  • Botmux — Bridge Feishu/Lark to AI coding CLIs — Claude Code, Codex, Gemini, OpenCode… every DM, group or topic spawns i 1.2k ★
  • Feishu MCP — Feishu / Lark 飞书文档与任务管理工具,支持 MCP 服务器和 CLI + Skill 两种使用方式,可无缝集成 Cursor、Claude Code、Cline 等 AI 编码工具 612 ★

README

Feishu-Skill

AI Skill,让 AI 通过 `feishu-tool` CLI 自动操作飞书文档、任务与用户。

简介

本项目是一个 AI Skill,配合 [Feishu-MCP](https://github.com/cso1z/Feishu-MCP) 使用。支持 Claude Code、Cursor 等主流 AI 编程工具,安装后 AI 能在合适场景下自动调用 `feishu-tool` CLI,完成飞书文档、任务、用户的增删改查操作,无需手动执行命令。

安装

第一步:安装 feishu-tool

npm install -g feishu-mcp@latest

要求 Node.js >= 20.17.0

第二步:安装 Skill

支持环境:macOS、Linux、Windows(Git Bash),不支持 CMD / PowerShell。

克隆本仓库后,运行安装脚本:

# 安装到全局(默认)
bash install.sh

# 或安装到指定项目
bash install.sh --project /path/to/your/project

第三步:配置环境变量

`feishu-tool` 支持通过命令直接配置,无需手动创建 `.env` 文件:

feishu-tool config set FEISHU_APP_ID 
feishu-tool config set FEISHU_APP_SECRET 
变量 必填 说明
FEISHU_APP_ID ✅ 飞书应用 ID
FEISHU_APP_SECRET ✅ 飞书应用密钥
FEISHU_AUTH_TYPE 否 tenant(默认)或 user
FEISHU_ENABLED_MODULES 否 document / task / member / all

让 AI 自动完成全部安装配置

将以下 prompt 直接发给 AI(Claude Code、Cursor 等),它会自动执行上述所有步骤:

请帮我安装 Feishu-Skill:

1. 将项目克隆到本地临时目录:
   git clone https://github.com/cso1z/Feishu-Skill.git /tmp/Feishu-Skill

2. 执行安装脚本(安装到全局 ~/.claude/skills):
   bash /tmp/Feishu-Skill/install.sh

3. 安装完成后,检查 feishu-mcp skill 是否已加载(确认 ~/.claude/skills/feishu-skill/SKILL.md 存在):
   - 若已加载,直接告知我已就绪,无需重启
   - 若未加载,告知我需要重启 AI 工具以加载 Skill

功能

模块 工具数 能力
Document 15 文件夹/文档/块/图片/白板的创建、读取、编辑、搜索
Task 4 任务创建(含子任务)、更新、删除、列表
Member 1 按姓名搜索或按 ID 批量获取用户

使用方式

安装后,直接用自然语言告诉 AI 你的飞书需求,Skill 会自动触发:

  • "在飞书创建一个文档,标题是『需求评审』"
  • "帮我列出今天截止的飞书任务"
  • "搜索飞书里关于架构设计的文档"

也可以直接使用 `feishu-tool` CLI:

# 查看 CLI 概览(子命令 + 可用工具集)
feishu-tool --help

# 查看初始化指南(获取 App ID / Secret 的步骤说明)
feishu-tool guide

# 写入凭证
feishu-tool config set FEISHU_APP_ID cli_xxxxx

# 查看当前配置(确认写入正确)
feishu-tool config

# 查看某个工具的详细参数
feishu-tool help create_feishu_document

# 调用工具
feishu-tool create_feishu_document '{"title": "测试文档"}'
`