larksuite-node-sdk-skill

飞书 / Lark 开放平台官方 Node.js SDK @larksuiteoapi/node-sdk 操作技能包。

该技能用于帮助 Agent 在项目中正确使用飞书官方 Node SDK，覆盖 IM、通讯录、日历、云盘、文档、Bitable、多维表格、审批、事件订阅、卡片回调、长连接等常见场景。

能力概览

• 封装 @larksuiteoapi/node-sdk 的常见调用模式
• 提供 Client 初始化、鉴权、域名切换、日志级别等建议
• 提供 IM、Contact、Drive、Calendar、Docx、Bitable 等业务域的调用示例
• 提供 HTTP Webhook 事件订阅与 WSClient 长连接示例
• 提供消息卡片回调 card.action.trigger 处理示例
• 强调凭证应从环境变量读取，避免硬编码

适用场景

• 用户明确要求使用 @larksuiteoapi/node-sdk
• 需要在 Node.js 项目中接入飞书开放平台
• 需要发送消息、查用户、上传文件、处理事件回调
• 没有更细分的专用 skill 可以覆盖当前需求

不建议使用的场景

以下场景优先使用更专门的 skill：

• 多维表格
• 日历
• 云文档
• 邮件
• 任务
• 通讯录专项能力

前置要求

• 准备好 APP_ID 和 APP_SECRET
• 如需访问用户侧数据，准备 USER_ACCESS_TOKEN
• 如需处理事件订阅，准备 ENCRYPT_KEY 和 VERIFICATION_TOKEN
• 所有敏感凭证均通过环境变量传入

使用方式

将本目录中的 SKILL.md 作为技能定义文件接入 Agent 系统即可。

如需在代码中使用飞书 SDK，可参考以下最小示例：

const lark = require('@larksuiteoapi/node-sdk');

const client = new lark.Client({
  appId: process.env.APP_ID,
  appSecret: process.env.APP_SECRET,
  appType: lark.AppType.SelfBuild,
  domain: lark.Domain.Feishu,
  loggerLevel: lark.LoggerLevel.info,
});

文件说明

• SKILL.md: 技能主定义文件，包含完整的技能说明与示例
• README.md: GitHub 展示说明文件

说明

本仓库聚焦于 Skill 定义与使用说明，不包含独立 npm 包发布内容。