ASD

Lark Skill Maker

Crea Skills personalizados para lark-cli, útil cuando hay que envolver operaciones de la API de Feishu en un Skill reutilizable (API atómica o flujo de varios pasos).

Estrellas
16.4k

en todo el repo

Actividad
37

0–100, la ruta de este skill

Actualizado
hace 4 meses

último commit aquí

Commits
0

últimos 90 días

Contexto
615 tok

39 tok en reposo

Paquete
1 archivo

2 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add larksuite/cli --skill lark-skill-maker --agent claude-code

Se instala solo en este repositorio.

Qué hace

  • Genera un nuevo SKILL.md en skills/lark-<name>/SKILL.md siguiendo una plantilla estándar
  • Guía la investigación de las APIs de lark-cli disponibles: lark-cli <service> --help, lark-cli schema, y lark-cli api para llamadas no registradas
  • Define la prioridad de uso: Shortcut > API ya registrada > llamada directa con lark-cli api
  • Indica cómo documentar permisos (scopes) y pasos de orquestación entre múltiples llamadas
  • Remite a lark-openapi-explorer cuando la API necesaria no está cubierta por el CLI

Úsalo cuando

  • El usuario necesita empaquetar una operación de la API de Feishu/Lark en un Skill reutilizable
  • Se requiere envolver una API atómica o encadenar varios pasos en un flujo (orquestación)

No lo uses cuando

    Qué lo activa

    Di cualquiera de estas frases y el agente debería cargar este skill.

    • Crea un Skill de lark-cli para reservar salas de reuniones
    • Necesito envolver esta API de Feishu en un Skill reutilizable
    • Ayúdame a documentar los scopes y pasos para un nuevo SKILL.md de lark-cli

    SKILL.md

    En inglés

    Skill Maker

    基于 lark-cli 创建新 Skill。Skill = 一份 SKILL.md,教 AI 用 CLI 命令完成任务。

    CLI 核心能力

    lark-cli <service> <resource> <method>          # 已注册 API
    lark-cli <service> +<verb>                      # Shortcut(高级封装)
    lark-cli api <METHOD> <path> [--data/--params]  # 任意飞书 OpenAPI
    lark-cli schema <service.resource.method>       # 查参数定义
    

    优先级:Shortcut > 已注册 API > api 裸调。

    调研 API

    # 1. 查看已有的 API 资源和 Shortcut
    lark-cli <service> --help
    
    # 2. 查参数定义
    lark-cli schema <service.resource.method>
    
    # 3. 未注册的 API,用 api 直接调用
    lark-cli api GET /open-apis/vc/v1/rooms --params '{"page_size":"50"}'
    lark-cli api POST /open-apis/vc/v1/rooms/search --data '{"query":"5F"}'
    

    如果以上命令无法覆盖需求(CLI 没有对应的已注册 API 或 Shortcut),使用 lark-openapi-explorer 从飞书官方文档库逐层挖掘原生 OpenAPI 接口,获取完整的方法、路径、参数和权限信息,再通过 lark-cli api 裸调完成任务。

    通过以上流程确定需要哪些 API、参数和 scope。

    SKILL.md 模板

    文件放在 skills/lark-<name>/SKILL.md

    ---
    name: lark-<name>
    version: 1.0.0
    description: "<功能描述>。当用户需要<触发场景>时使用。"
    metadata:
      requires:
        bins: ["lark-cli"]
    ---
    
    
    # <标题>
    
    > **前置条件:** 先阅读 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)。
    
    ## 命令
    
    \```bash
    # 单步操作
    lark-cli api POST /open-apis/xxx --data '{...}'
    
    # 多步编排:说明步骤间数据传递
    # Step 1: ...(记录返回的 xxx_id)
    # Step 2: 使用 Step 1 的 xxx_id
    \```
    
    ## 权限
    
    | 操作 | 所需 scope |
    |------|-----------|
    | xxx | `scope:name` |
    

    关键原则

    • description 决定触发 — 包含功能关键词 + "当用户需要...时使用"
    • 认证 — 说明所需 scope,登录用 lark-cli auth login --domain <name>
    • 安全 — 写入操作前确认用户意图,建议 --dry-run 预览
    • 编排 — 说明数据传递、失败回滚、可并行步骤

    Reproducido de larksuite/cli bajo licencia MIT. Leer esta página en markdown.

    Archivos

    1 archivo en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

    Antes de instalar

    Requiere el binario lark-cli instalado y, para APIs no registradas, puede necesitar lark-openapi-explorer.

    Detalles

    Creador
    larksuite
    Licencia
    MIT
    Recursos incluidos
    Solo SKILL.md
    Repositorio
    larksuite/cli
    Código fuente
    Ver SKILL.md

    Más de larksuite/cli

    Este repo incluye 28 skills. Si instalas uno, normalmente ya tienes los demás.

    飞书幻灯片: crea y edita presentaciones, lee contenido de slides, gestiona páginas (crear, eliminar, leer, reemplazo parcial). No cubre documentos, pizarras ni archivos generales.

    Costo de contexto al activarse
    7k tok
    Tamaño del paquete
    50 archivos
    Última actualización
    hace 3 días
    documentos

    Drive de Feishu/Lark: gestiona archivos y carpetas (subir/descargar, copiar/mover/eliminar, metadatos, permisos, comentarios, versiones, etiquetas de confidencialidad) e importa archivos locales como docx/sheet/bitable/slides.

    Costo de contexto al activarse
    6.3k tok
    Tamaño del paquete
    61 archivos
    Última actualización
    hace 3 días
    documentos

    Operaciones sobre documentos en la nube de Lark (Docx/Wiki): leer, crear y editar documentos, insertar o descargar imágenes/adjuntos, y gestionar notas mentales.

    Costo de contexto al activarse
    1k tok
    Tamaño del paquete
    44 archivos
    Última actualización
    hace 3 días
    documentos

    Operaciones en Lark Base (multitabla): tablas, campos, registros, vistas, fórmulas/lookup, formularios, dashboards, workflows y roles; se usa ante Base/多维表格/bitable o enlaces /base/.

    Costo de contexto al activarse
    6.2k tok
    Tamaño del paquete
    30 archivos
    Última actualización
    anteayer
    bases de datos

    Lark Im

    16.4k

    Mensajería instantánea de Feishu/Lark: enviar y responder mensajes, buscar historial, gestionar miembros de grupo, subir/descargar archivos, reacciones, avisos urgentes y tarjetas interactivas con sus callbacks.

    Costo de contexto al activarse
    5.3k tok
    Tamaño del paquete
    59 archivos
    Última actualización
    hace 7 días
    automatizacion

    Desarrollo y hosting de apps Miaoda/Spark: creación, desarrollo local o en la nube, diseño creativo, integraciones de IA/Feishu, logs, métricas, variables de entorno, colaboradores, roles y triggers.

    Costo de contexto al activarse
    6.2k tok
    Tamaño del paquete
    55 archivos
    Última actualización
    hace 3 días
    herramientas desarrollo

    Skills relacionados

    Úsalo al empezar trabajo de feature que necesita aislamiento del workspace actual, o antes de ejecutar planes de implementación: asegura un workspace aislado vía herramientas nativas o fallback a git worktree.

    Costo de contexto al activarse
    1.7k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    el mes pasado
    herramientas desarrollo

    Úsala al crear nuevas skills, editar skills existentes o verificar que funcionan antes de desplegarlas.

    Costo de contexto al activarse
    6.6k tok
    Tamaño del paquete
    7 archivos
    Última actualización
    anteayer
    herramientas desarrollo

    Parte un plan, una spec o la conversación actual en tickets tracer-bullet, cada uno declarando sus aristas de bloqueo, publicados en el tracker configurado.

    Costo de contexto al activarse
    1.4k tok
    Tamaño del paquete
    2 archivos
    Última actualización
    hace 24 días
    herramientas desarrollo