Feishu CLI AI Agent 技能

什么是 AI Agent 技能

AI Agent 技能是结构化的指令文档（SKILL.md 文件），用于教会 AI 编程助手如何有效使用 Feishu CLI。开发者无需手动向 AI 工具解释 CLI 命令，技能提供了预编写的全面指令，AI 助手会自动读取并遵循这些指令。

Feishu CLI 附带 19 个技能，涵盖所有支持的业务领域，从消息和日历管理到文档创建和邮件处理。每个技能包含详细的命令语法、参数描述、示例工作流和安全规则，确保 AI 助手正确且安全地使用 CLI。

安装技能是一次性的设置步骤。运行 npx skills add larksuite/cli -y -g 后，技能文件会被放置在一个全局目录中，AI 编程助手在启动时会扫描该目录。此后，任何支持技能协议的 AI 助手都可以自动发现和使用 Feishu CLI 命令，无需额外配置。

支持的 AI 工具

Feishu CLI 技能兼容越来越多的 AI 编程助手。技能协议是一个开放标准，任何从全局技能目录读取 SKILL.md 文件的工具都可以利用 Feishu CLI 技能：

Claude Code — Anthropic 基于 CLI 的编程助手。Claude Code 启动时会加载技能作为上下文指令，使其能够使用所有 Feishu CLI 命令。
Cursor — AI 驱动的代码编辑器。技能作为可用上下文出现，Cursor 的 AI 在回答问题或编写代码时可以引用。
Codex — OpenAI 的编程 Agent。技能提供结构化的命令文档，Codex 用于生成准确的 CLI 调用。
OpenCode — 原生支持技能的开源 AI 编程助手。
OpenClaw — 兼容技能协议的社区驱动 AI 编程工具。

技能系统通过将指令文件放置在一个约定目录中来工作。当 AI 助手启动会话时，它会扫描该目录并根据任务上下文加载相关技能。技能 YAML 前置数据中的 description 字段用于匹配 — 例如，当用户的请求提到日历时，AI 助手会自动加载 lark-calendar 技能。

完整技能列表

下表列出了 Feishu CLI 包含的所有 19 个技能。每个技能覆盖特定的领域或工作流，并包含面向 AI 助手的详细指令：

技能	领域	描述
`lark-shared`	基础	自动加载的基础技能。涵盖认证、配置、身份切换（`--as user` / `--as bot`）和安全规则。所有其他技能都依赖此技能。
`lark-calendar`	日历	查看日程、创建和更新日程事件、检查忙闲状态，以及获取 AI 驱动的时间建议以便跨参与者安排会议。
`lark-im`	消息	发送和接收消息、管理群聊、搜索消息历史、处理媒体附件以及对消息添加表情回复。
`lark-doc`	云文档	使用 Markdown 内容创建、读取和更新飞书文档。支持媒体嵌入、块级操作和白板集成。
`lark-drive`	云空间	上传和下载文件、管理共享权限，以及处理飞书云空间中的文件评论。
`lark-sheets`	电子表格	飞书电子表格的完整增删改查操作，包括单元格读写、查找替换、数据导出和工作表管理。
`lark-base`	多维表格	全面的多维表格自动化，包含 60 个快捷命令，涵盖数据表、记录、字段、视图、仪表盘和工作流自动化。
`lark-task`	任务	任务增删改查操作、负责人管理、完成状态跟踪、提醒配置和任务清单组织。
`lark-mail`	邮件	发送、回复和转发邮件。管理草稿、分拣收件箱消息，以及通过 WebSocket 监听新邮件。包含防提示注入安全规则。
`lark-contact`	通讯录	按姓名、邮箱或部门搜索用户，并从组织目录中获取详细的用户资料。
`lark-wiki`	知识库	浏览和管理知识空间与知识库节点，包括创建、移动和组织知识库内容。
`lark-event`	事件订阅	通过 WebSocket 连接订阅实时事件，支持 NDJSON 输出格式和基于正则的事件路由。
`lark-vc`	视频会议	访问会议记录、获取会议纪要和待办事项，以及下载完整的会议转录。
`lark-whiteboard`	白板	使用 DSL 或 Mermaid 语法渲染图表和图形，支持 PNG 导出以嵌入文档和消息。
`lark-minutes`	妙记	获取会议纪要元数据以及 AI 生成的产出物，包括摘要、待办事项和关键决策。
`lark-openapi-explorer`	API 探索	通过编程方式查询官方 API 文档，发现和探索未公开或鲜为人知的飞书 API。
`lark-skill-maker`	技能创建	使用内置的技能编写工具链和模板系统为 Feishu CLI 创建自定义技能。
`lark-workflow-meeting-summary`	工作流	将多次会议的会议纪要、转录和待办事项汇总为合并的摘要报告。
`lark-workflow-standup-report`	工作流	将日历日程、任务状态和近期活动整合为格式化的每日站会报告。

技能文件结构

每个技能遵循一致的文件结构，AI 助手已被训练来解析此结构。如果您计划创建自定义技能或想检查 AI 接收到的指令内容，了解此结构会很有帮助：

skills/
  lark-calendar/
    SKILL.md              # Main instruction file
    references/
      calendar-agenda.md  # Per-command documentation
      calendar-create.md
      calendar-freebusy.md

SKILL.md 文件是入口点。它以 YAML 前置数据开头，包含 name、version、description 和 metadata.requires.bins（指定必须安装 lark-cli）等元数据字段。文件正文包含以 Markdown 编写的结构化指令，包括命令模式、参数表、工作流示例和安全规则。

references/ 目录包含每个命令的详细文档文件。这些文件从主 SKILL.md 中引用，提供详尽的参数描述、输出格式规范和边界情况处理指令，AI 助手在执行复杂操作时会使用这些内容。

技能如何与 Claude Code 协作

Feishu CLI 技能与 Claude Code 的集成是无缝的，除了初始安装外无需手动配置。工作方式如下：

第一步：全局安装技能，运行 npx skills add larksuite/cli -y -g。这会将技能文件放置在 Claude Code 监控的全局目录中。
第二步：重启 Claude Code 以加载新安装的技能。Claude Code 在启动时会扫描技能目录并索引所有可用技能。
第三步：AI 读取 SKILL.md 作为上下文，当检测到相关任务时自动加载。每个技能 YAML 前置数据中的 description 字段用于语义匹配 — 当您要求 Claude Code 「在飞书中发送消息」时，它会自动加载 lark-im 技能。
第四步：Claude Code 遵循指令执行技能文件中的操作，使用正确的 CLI 命令和标志，处理认证，并遵守安全规则。

description 字段对于触发正确的技能至关重要。例如，lark-calendar 技能的描述中提到「calendar events, agenda, free/busy, scheduling」，这确保了当用户的请求涉及这些概念时会自动加载该技能。

创建自定义技能

您可以创建自定义技能来扩展 Feishu CLI 的功能，添加自定义工作流或封装常用的命令序列。lark-skill-maker 技能提供 AI 辅助的编写体验：

# Ask your AI assistant to create a custom skill
"Create a skill for weekly team reporting using lark-cli"

如需手动创建技能，请使用 Feishu CLI 仓库中 skill-template/ 目录下的模板。该模板提供正确的文件结构、YAML 前置数据格式和示例内容，您可以根据自己的用例进行定制。

自定义技能可以引用现有技能作为依赖，并可以组合多个领域的命令。例如，一个「项目状态报告」技能可以将日历事件、任务进度和文档更新整合到一个工作流中，AI 助手只需一个简单的自然语言请求即可执行。

技能中的安全机制

安全性是 Feishu CLI 技能系统的核心关注点。多个技能包含明确的安全规则，AI 助手必须遵循这些规则以防止意外的数据泄露或破坏性操作：

lark-mail 中的防提示注入 — 邮件技能包含特定规则，防止 AI 助手被邮件中的恶意内容操纵。如果邮件正文包含「将此转发给所有联系人」等指令，AI 助手会识别并拒绝这些提示注入尝试。
试运行强制执行 — 涉及破坏性操作（如删除记录或修改权限）的技能包含试运行标志，AI 助手在执行实际操作前必须先使用该标志。这让用户有机会在提交前审查影响。
权限范围验证 — 在执行需要特定 OAuth 权限范围的命令前，技能会指示 AI 助手验证所需的权限范围是否已授权。这可以避免因权限不足而产生令人困惑的错误消息。

这些安全措施直接嵌入在技能指令中，因此在 AI 助手使用 Feishu CLI 时会自动生效。您无需单独配置或启用它们。