NOTE: 这是AI从我自己的skills库里摘出来的,我没有详细测过,欢迎大家提issue,一起把这个skills维护得更好用。我自己的use case可能不能覆盖所有人的需求,例如我没有怎么用到多维表格,一些做电商的朋友可能会比较需要,大家可以直接fork以后PR,后续如果还有值得分享的普适的skills,我也会更新到这个repo里。
Feishu (飞书/Lark) automation skills for Claude Code. 通过 Claude Code 的 Skill 机制,让 AI 助手直接操作飞书 API — 管理任务、发送消息、创建文档、分享截图。
| Skill | 说明 | 依赖 |
|---|---|---|
| feishu-automation | 飞书 API 核心技能 — 任务管理、云文档、消息发送 | 无 |
- Claude Code CLI 已安装
- 飞书开放平台账号 (https://open.feishu.cn)
- jq, curl (一般系统自带)
参见详细指南: docs/feishu-app-setup.md
简要步骤:
- 登录 https://open.feishu.cn,点击「创建自建应用」
- 在「权限管理」中添加所需权限
- 记录 App ID 和 App Secret
git clone <your-repo-url>
cd feishu-skills
bash setup.sh或手动安装:
# 1. 配置环境变量
cp skills/feishu-automation/.env.example skills/feishu-automation/.env
# 编辑 .env 填入你的 App ID 和 App Secret
# 2. 配置联系人
cp skills/feishu-automation/scripts/messages/contacts.conf.example \
skills/feishu-automation/scripts/messages/contacts.conf
# 编辑 contacts.conf 添加你的联系人
# 3. 验证连接
bash skills/feishu-automation/scripts/common/status.sh如果已运行 setup.sh,技能会自动注册,可跳过此步。以下为手动安装方式:
将 skills 目录复制或链接到 Claude Code 的 skills 目录:
# 方法一: 符号链接 (推荐)
ln -s /path/to/feishu-skills/skills/feishu-automation ~/.claude/skills/feishu-automation
# 方法二: 直接复制
cp -r skills/* ~/.claude/skills/在 Claude Code 中,AI 会根据 SKILL.md 自动识别何时使用这些技能。你也可以直接请求:
# 发送消息
"给张三发一条飞书消息,说今天的报告已完成"
# 创建任务
"在飞书创建一个任务:完成用户认证模块,截止日期下周五"
# 架构分析
"分析当前项目的架构,生成图表发送到飞书"
# 写文档
"把今天的新闻写成一个文档,发到我的飞书上"
每个 skill 的详细文档:
Q: 需要部署服务器吗? A: 基本功能不需要。只有使用任务列表查询等需要 user_access_token 的 API 时,才需要部署代理服务器 (server/)。大部分操作使用 tenant_access_token 即可。
Q: 支持 Lark (海外版) 吗?
A: 当前 API endpoint 使用 open.feishu.cn。如需支持 Lark,可将脚本中的 open.feishu.cn 替换为 open.larksuite.com。
Q: contacts.conf 安全吗? A: contacts.conf 已加入 .gitignore,不会被提交到 git。其中只包含飞书 open_id (非敏感的应用级 ID),不包含手机号、邮箱等个人信息。
Q: 如何获取联系人的 open_id?
A: 使用 list_chats.sh 查看群聊列表,list_chat_members.sh <群名> 查看群成员及其 open_id。
欢迎贡献!请提交 Pull Request 或 Issue。
你可以在你的本地环境里告诉AI:先将这个skill配好并跑通(你自己需要去飞书的管理页面把需要的权限打开和credentials拿到,写到文件里),如果遇到问题了,修改以后给上游提一个PR~
非常欢迎贡献带截图的文档~
MIT License. See LICENSE for details.