Feishu Skill

飞书 (Lark) Agent Skill，为 AI 助手扩展飞书 API 交互能力，支持文档、知识库、云盘、权限、即时消息等场景的自动化操作。

✨ 功能特性

• 📝 文档管理：读取、写入、创建飞书 Docx 文档，管理文档评论
• 📚 知识库管理：获取知识库空间列表、查询知识库节点详情
• 📂 云盘管理：列出云盘文件夹内容，管理文件
• 🔐 权限管理：查询、管理文档/文件的协作者权限
• 💬 即时消息：获取群聊/话题消息列表
• 🚀 命令行交互，使用简单，易于集成到自动化工作流

📦 前置要求

• Node.js >= 18.x
• 飞书开放平台应用，拥有对应的 API 权限

🛠️ 安装

作为一个 Agent Skill，你可以使用 skills CLI 一键安装到你的 Agent 环境（支持 OpenCode, Cursor, Claude Code, Codex 等）：

# 从 GitHub 直接安装技能到你的 agent
npx skills add https://github.com/tzwm/feishu-skill/tree/main/skills/feishu

或者使用 GitHub 简写格式：

npx skills add tzwm/feishu-skill

⚙️ 配置

你需要在飞书开放平台创建企业自建应用，并获取以下凭证：

• LARK_APP_ID：飞书应用 ID
• LARK_APP_SECRET：飞书应用密钥

将以上环境变量添加到你的终端环境，或者在 skills/feishu 目录下创建 .env 文件写入：

LARK_APP_ID=your_app_id
LARK_APP_SECRET=your_app_secret

⚠️ 注意：需要给飞书应用开启对应的 API 权限，才能使用对应功能。

🚀 使用方法

作为命令行工具，所有命令都在 skills/feishu 目录下执行：

文档操作

# 读取文档内容
pnpm start doc read -t <doc_token_or_url>

# 写入文档内容（替换全部内容为 Markdown）
pnpm start doc write -t <doc_token> --content "# 标题\n新的文档内容"

# 列出文档评论
pnpm start doc list-comments -t <doc_token>

知识库操作

# 列出可访问的知识库空间
pnpm start wiki spaces

# 获取知识库节点详情
pnpm start wiki get -t <wiki_token_or_url>

云盘操作

# 列出文件夹内容
pnpm start drive list -f <folder_token>

权限管理

# 列出协作者
pnpm start perm list -t <file_token> --type docx

即时消息操作

# 获取群聊/话题消息列表
pnpm start im messages -c <chat_id>

查看更多命令选项：

pnpm start --help
# 或查看子命令帮助
pnpm start doc --help

🤝 贡献

欢迎提交 Issue 和 Pull Request！详见 CONTRIBUTING.md。

📄 许可证

MIT License，详见 LICENSE 文件。