📦

lark-base

Name: lark-base
Author: larksuite

Seguro

Assistant CLI Lark Base

Permet aux agents IA d'utiliser des tables multidimensionnelles Lark/Feishu (Base) via des commandes CLI atomiques, prenant en charge la gestion des tables, la configuration des champs, les opérations CRUD sur les enregistrements, la configuration des vues, l'automatisation des workflows, les formulaires, les tableaux de bord et les requêtes d'analyse de données.

Soporta: Claude Codex Code(CC)

🥉 74 Bronce

Descargar el ZIP de la skill

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

Activa y empieza a usar

Pruébalo

Usando "lark-base". Créez une table 'Projects' avec les champs : Name (texte), Start Date (date), End Date (date), Status (sélection unique), et un champ de formule 'Duration Days' qui calcule la différence entre End Date et Start Date.

Resultado esperado:

Table 'Projects' créée avec succès avec table_id 'tblXXXXXXXX'. Champs créés : Name (texte), Start Date (date), End Date (date), Status (sélection unique), Duration Days (formule avec expression 'DATEDIF([Start Date], [End Date], "D")').

Usando "lark-base". Interrogez tous les enregistrements de la table 'Orders' où Status est 'Completed' et Amount > 500, triés par Order Date en ordre décroissant, limite 10 enregistrements.

Resultado esperado:

10 enregistrements trouvés correspondant aux critères : [{OrderID: 'ORD-001', Customer: 'Acme Corp', Amount: 1200, Status: 'Completed', OrderDate: '2024-03-15'}, ...]

Auditoría de seguridad

Seguro

v1 • 3/31/2026

This is a documentation-only skill for the lark-cli Base module. All 4703 static analysis findings are false positives from pattern-matching on markdown documentation files. The detected 'external_commands' are CLI command syntax examples in documentation (e.g., 'lark-cli base +table-list'), not executable code. The 'filesystem' and 'network' findings reference documentation paths, not actual file or network operations. No source code files (.js, .ts, .py, .sh, etc.) exist in this skill - only SKILL.md and reference markdown files. The skill instructs AI agents to use CLI commands for Lark/Feishu Base operations but contains no executable logic itself. Safe to publish.

Archivos escaneados

9,609

Líneas analizadas

hallazgos

Auditorías totales

No se encontraron problemas de seguridad

Auditado por: claude

Puntuación de calidad

Arquitectura

100

Mantenibilidad

Contenido

Comunidad

100

Seguridad

100

Cumplimiento de la especificación

Lo que puedes crear

Gestion des Tables et des Champs

Créer de nouvelles tables Base avec des schémas de champs personnalisés, mettre à jour les configurations de champs et gérer le cycle de vie des tables. Prend en charge tous les types de champs incluant les champs de formule et de recherche pour les valeurs calculées.

Opérations sur les Enregistrements et Analyse de Données

Effectuer des opérations CRUD sur les enregistrements avec prise en charge par lots, interroger les enregistrements avec des filtres basés sur les vues, et exécuter des requêtes d'agrégation côté serveur pour les statistiques, classements et analyses groupées.

Automatisation de Workflow et Tableaux de Bord

Construire des workflows automatisés avec déclencheurs (ajout/modification d'enregistrement/minuteur) et actions (créer un enregistrement, envoyer un message, génération de texte IA). Créer des tableaux de bord avec des blocs graphiques pour la visualisation de données.

Prueba estos prompts

Créer une Table Base avec des Champs

Je dois créer une nouvelle table appelée 'Orders' dans ma Base avec les champs : Order ID (numéro automatique), Customer Name (texte), Amount (nombre), Status (sélection unique avec les options Pending/Processing/Completed), et Order Date (date). Créez la table et les champs.

Analyser les Données avec une Requête d'Agrégation

Montrez-moi le montant total des ventes groupé par statut, et trouvez les 5 meilleurs clients par montant total de commande. Utilisez l'agrégation côté serveur pour calculer ces statistiques.

Créer un Champ de Formule pour les Valeurs Calculées

Ajoutez un champ de formule appelé 'Profit Margin' qui calcule (Revenue - Cost) / Revenue en pourcentage. Ajoutez également un champ de formule pour signaler les commandes de plus de 7 jours comme 'Overdue'.

Configurer l'Automatisation de Workflow

Créez un workflow qui se déclenche lorsqu'une nouvelle commande est ajoutée avec un montant supérieur à 1000, et envoie un message de notification au canal de l'équipe commerciale avec les détails de la commande.

Mejores prácticas

Toujours lire la structure des champs avec +field-list avant d'écrire des enregistrements pour comprendre les types de champs et les champs inscriptibles
Utiliser +data-query pour l'analyse d'agrégation (SUM, COUNT, GROUP BY) au lieu de récupérer tous les enregistrements avec +record-list et de calculer manuellement
Lire formula-field-guide.md ou lookup-field-guide.md avant de créer des champs calculés pour s'assurer que la syntaxe des expressions est correcte
Exécuter les opérations de liste (+table-list, +field-list, +record-list) en série, pas en parallèle, pour éviter la limitation de débit
Pour les liens wiki, toujours résoudre vers obj_token via 'wiki spaces get_node' avant d'utiliser comme base-token

Evitar

Ne pas utiliser +record-list pour l'analyse d'agrégation - utiliser +data-query pour le calcul côté serveur
Ne pas tenter d'écrire dans les champs système, les champs de formule ou les champs de recherche - ils sont en lecture seule
Ne pas deviner les noms de table/champ à partir du langage naturel - toujours récupérer les noms réels via +table-list / +field-list
Ne pas passer wiki_token directement comme base-token - doit être résolu via l'API get_node d'abord
Ne pas créer de champs de formule/recherche sans avoir lu les documents de guide d'abord

Preguntas frecuentes

Comment créer un champ de formule qui référence une autre table ?

Lisez d'abord formula-field-guide.md. Pour les références inter-tables, utilisez la syntaxe TableName.FieldName avec CurrentValue pour l'itération. Exemple : [Orders].[Amount].FILTER(CurrentValue > 100).SUM() additionne les montants supérieurs à 100. Obtenez d'abord la structure de la table cible pour vérifier les noms de champs.

Quelle est la différence entre SetRecordTrigger et ChangeRecordTrigger ?

SetRecordTrigger se déclenche uniquement lors des modifications d'enregistrements, tandis que ChangeRecordTrigger se déclenche lors des ajouts et des modifications. En cas de doute, utilisez ChangeRecordTrigger pour une couverture plus large.

Comment gérer la pagination pour les grands ensembles d'enregistrements ?

Utilisez +record-list avec --limit 200 (maximum autorisé) et incrémentez le paramètre --offset de 200 pour chaque page jusqu'à ce que moins de 200 enregistrements soient retournés.

Pourquoi ne puis-je pas écrire dans un champ avec +record-upsert ?

Les champs système (heure de création, heure de mise à jour, créateur, modificateur), les champs de formule et les champs de recherche sont en lecture seule. Seuls les champs de stockage (texte, nombre, date, sélection, etc.) peuvent être écrits. Utilisez +field-list pour vérifier les types de champs.

Comment activer la gestion des rôles personnalisés ?

Activez d'abord le mode de permission avancé avec +advperm-enable. Ensuite, vous pouvez créer des rôles personnalisés avec +role-create, mettre à jour avec +role-update, et gérer les permissions via base_rule_map, table_rule_map, dashboard_rule_map et docx_rule_map.

Que dois-je faire si je reçois l'erreur 'base_token invalid' ?

Si vous utilisez un lien wiki, vous devez d'abord le résoudre via 'lark-cli wiki spaces get_node' et utiliser node.obj_token comme base-token. N'utilisez pas wiki_token ou les URLs complètes directement.