Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Feishu Skills for Claude Code

NOTE: 这是AI从我自己的skills库里摘出来的,我没有详细测过,欢迎大家提issue,一起把这个skills维护得更好用。我自己的use case可能不能覆盖所有人的需求,例如我没有怎么用到多维表格,一些做电商的朋友可能会比较需要,大家可以直接fork以后PR,后续如果还有值得分享的普适的skills,我也会更新到这个repo里。

Feishu (飞书/Lark) automation skills for Claude Code. 通过 Claude Code 的 Skill 机制,让 AI 助手直接操作飞书 API — 管理任务、发送消息、创建文档、分享截图。

Skills 一览

Skill 说明 依赖
feishu-automation 飞书 API 核心技能 — 任务管理、云文档、消息发送

快速开始

前置条件

第一步:创建飞书应用

参见详细指南: docs/feishu-app-setup.md

简要步骤:

  1. 登录 https://open.feishu.cn,点击「创建自建应用」
  2. 在「权限管理」中添加所需权限
  3. 记录 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

第三步:在 Claude Code 中使用

如果已运行 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 的详细文档:

FAQ

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。

Contributing

欢迎贡献!请提交 Pull Request 或 Issue。

你可以在你的本地环境里告诉AI:先将这个skill配好并跑通(你自己需要去飞书的管理页面把需要的权限打开和credentials拿到,写到文件里),如果遇到问题了,修改以后给上游提一个PR~

非常欢迎贡献带截图的文档~

License

MIT License. See LICENSE for details.

About

An open implementation for Feishu Skills, allowing agents to send messages, write documents, managing TODOs for you.

Resources

Stars

14 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages