feishu-agent

Parse Feishu Bitable URLs and perform natural-language CRUD operations.

1|Updated May 17, 2026
One-click install
npx skills add https://github.com/mykcs/myk-skills --skill feishu-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feishu-agent
Source: https://github.com/mykcs/myk-skills/tree/main/feishu-agent
Command: npx skills add https://github.com/mykcs/myk-skills --skill feishu-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

将飞书 Bitable 的重复摩擦(URL/token 解析、字段映射、OAuth scope 适配、schema 获取与缓存)封装成一次调用的持久化代理,减少你在“能不能写入/该用哪个字段/权限够不够”的来回排查时间。

Core Features & Use Cases

  • URL 自动解析与缓存:把飞书 Wiki / Base / Record URL 解析为 app_token、table_id、record_id,并将解析结果缓存到 EverMem(TTL 7 天)以加速后续操作。
  • Schema 内省与缓存:按 base 拉取字段、类型、选项枚举,并缓存到 EverMem,避免每次都重复查询。
  • Natural-language CRUD(Upsert-First):支持自然语言的增删改查,并在写入前先查重(按唯一字段)再 PATCH/CREATE,降低重复数据与误操作风险。
  • 破坏性操作确认与安全边界:对 delete 等破坏性行为要求用户确认,并避免修改字段类型导致的数据丢失。
  • OAuth scope 自动映射:把人类可读的权限描述映射到 lark-cli 标准 scope,并在 permission_denied 时提示重新授权。

Quick Start

调用时请使用指令 /feishu list <表名> where <条件> 来直接查询并返回结构化结果。

Frequently Asked Questions about feishu-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform CRUD operations on Feishu Bitable records using natural language?

You can perform Feishu Bitable CRUD operations by issuing natural language commands like `/feishu list <table> where <condition>`. The agent parses the URL, validates the schema, and applies upsert-first logic to safely create, update, or delete records.

How does URL parsing work for Feishu Bitable automation?

URL parsing for Feishu Bitable automation extracts app_token, table_id, and optional record_id directly from Wiki, Base, or Record URLs. Results are cached in EverMem with a 7-day TTL to accelerate subsequent automated operations.

Can I use natural language to safely update records without causing data loss in Feishu?

Yes, natural language updates use upsert-first logic to query for duplicates before patching or creating records. Destructive actions like delete require explicit confirmation, preventing accidental data loss during automation.

Do I need to manually configure OAuth scopes for lark-cli to access Feishu Bitable?

No, the agent automatically maps human-readable permission descriptions to standard lark-cli authorization scopes. If permission is denied, it prompts you to re-authorize without requiring manual scope configuration.

What happens when I try to delete Feishu Bitable records through this automation agent?

Deleting Feishu Bitable records triggers a guarded write mechanism that requires explicit user confirmation before executing the destructive action. This safety boundary prevents accidental data deletion during automated workflows.

Why does my Feishu Bitable workflow keep repeating schema and field mapping queries?

Repeating schema queries happens without caching. This agent introspects fields, types, and option enumerations per base, caching the schema in EverMem to eliminate redundant lookups and accelerate persistent data workflows.