Dingtalk Ai Table

This handles all operations for DingTalk's AI Tables, the .able format multidimensional spreadsheets that live in their collaboration platform. You can create and manage sheets, fields, and records through the Notable API without touching the web interface. The skill includes a helper script that manages token caching and converts user IDs to the unionId format that the API requires. It walks you through configuration on first run, asking for your app credentials and base ID extracted from the share link. Worth noting that it emphasizes writing multi-line commands to temp files before execution, which suggests the underlying command environment has some quirks with heredocs and variable substitution. If you're building workflows that need to manipulate DingTalk tables programmatically, this gets you there.

skills.sh installs: 668
GitHub stars: 102
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add breath57/dingtalk-skills --skill dingtalk-ai-table --agent claude-code

Installs into .claude/skills of the current project.

Files

钉钉 AI 表格技能

负责钉钉 AI 表格（.able 格式多维表格）的所有操作。本文件为策略指南，仅包含决策逻辑和工作流程。完整 API 请求格式见文末「references/api.md 查阅索引」。

核心概念

AI 表格（.able 文件）：多维表格，使用 Notable API（/v1.0/notable），不是普通电子表格
base_id：AI 表格文件的 nodeId，从分享链接 https://alidocs.dingtalk.com/i/nodes/<base_id> 提取
工作表（Sheet）：表格内的单张表，包含字段和记录
字段（Field）：列定义，有名称和类型（text、number、date）
记录（Record）：数据行，fields 中用字段名称（非 ID）作键
operatorId：所有接口必须的 unionId 参数，通过 dt_helper.sh --to-unionid 自动转换

工作流程（每次执行前）

先识别本次任务类型 → 例如：列工作表、创建字段、查询记录、更新记录、删除记录
按本次任务校验所需配置 → 通过 bash scripts/dt_helper.sh --get KEY 读取；仅校验本任务必须项
仅收集缺失配置 → 若缺少某项，一次性询问用户所有缺失值，用 bash scripts/dt_helper.sh --set KEY=VALUE 写入
获取 Token / operatorId → 直接调用 bash scripts/dt_helper.sh，token 获取与缓存细节无需关心
执行操作 → 凡是包含变量替换、管道或多行逻辑的命令，写入 /tmp/<task>.sh 再 bash /tmp/<task>.sh 执行。不要把多行命令直接粘到终端里（终端工具会截断），也不要用 <<'EOF' 语法（heredoc 在工具中同样会被截断导致变量丢失）