SKILL.md
钉钉 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 在工具中同样会被截断导致变量丢失）