钉钉 AI 表格 Skill

最小 DWS 执行契约

• 只通过 dws CLI 操作钉钉；结构化读取使用 --format json，按真实返回判断结果。
• 已知命令直接执行。只有 leaf 参数或安全语义不确定时读取精确 Schema，只有 Cobra flag 不确定时读取精确 leaf Help；不要加载产品级 Catalog 代替选路。
• 不猜命令、flag、字段、ID、账号或时间。后续 ID 必须来自真实返回；零命中、多候选或类型不明时停止并消歧。
• 解析目标、读取上下文和最终执行必须使用同一 profile；不得跨组织复用 userId、openDingTalkId 或 openConversationId。多账号组织只使用明确的 isOrgCurrent=true 默认账号；没有默认账号时要求用户指定，禁止选择第一项、最近登录或最近使用账号。
• 不输出或记录 token、refresh token、appSecret、webhook token 等凭据；宿主已注入认证时不要索要凭据。
• 写操作必须符合用户明确意图。是否需要确认以最终 Runtime gate 和 Schema 为准；本轮用户已明确要求执行、目标与影响无歧义的非破坏性写操作时，该明确指令就是本次确认，首次调用直接携带 Runtime 所需的 --yes，不先制造 confirmation_required。删除、停用自动化等破坏性或高风险动作仍须先说明对象、动作与影响并取得独立确认。
• 写后按任务结果契约验证；不能仅凭退出码宣称成功。部分结果、未知投递状态和失败项必须如实保留。
• 时间戳面向用户展示时转换为带时区的可读时间；默认使用当前会话时区，必要时同时保留原值。
• 遇到认证、权限、profile、confirmation 或未知错误时，只加载 dingtalk-shared 中对应 reference；不要连续猜测替代命令。

Shortcut 发现（按需）

aitable 当前有 100 条公开 shortcut，完整清单保留在 Runtime Catalog 与 Schema，不在高频产品根 Skill 中重复展开。已知意图直接使用下方的优先路由、意图表或任务 reference；命令已选中时直接执行，只在参数/安全语义不确定时读取 leaf Schema，在当前 Cobra flags 不确定时读取 leaf Help。

仅当现有路由和 reference 都无法定位低频能力时，才执行 dws shortcut list --service aitable --format json 做最后回退；不要为已知高频意图加载完整 Shortcut Catalog 或产品级 Schema。

Golden Route

已有 ID 直接使用；完整 URL 先解析；名称先唯一解析为稳定 ID。零命中或多候选时停止，不默认选第一项。

常用 leaf 直达

参数已知时直接执行，不探测 Help/Catalog：Base 查看/改名用 +base-get / +base-update；模板搜索用 +template-search，再把真实 templateId 交给 base create --template-id；Table 查看/更新用 +table-get / +table-update；视图创建/复制用 view create / +view-duplicate；仪表盘创建/更新/读回用 dashboard create / +dashboard-update / +dashboard-get；表单分享用 +form-share-update / +form-share-get；查看自动化用 +workflow-list；数据源查看来源用 +datasource-list-sources，获取字段用 +datasource-get-fields，创建/更新/同步/查状态/查配置用 +datasource-create / +datasource-update / +datasource-sync / +datasource-sync-status / +datasource-get-config。

低频入口

字段配置用 +field-*；删记录用 +record-delete；附件用 +attachment-*。批量分享记录用 +record-share-links --base <B> --table <T> --record-ids <IDs>。其余能力使用同名前缀 leaf。

当前最短路径

• 已有 ID 直接使用；URL 只解析一次；“唯一定位并操作”用 +resolve-base / +resolve-table，“搜索候选/存在性检查”直接用 +base-search，两条路径不要串行探测。filters/sort 缺 fieldId 时才读取字段目录。
• Golden Route 已给出准确命令和参数时直接执行；不预读或默认读取通用 references/aitable.md。只有操作参数、JSON 结构或恢复语义确实缺失时，才读取下方一个精确操作 Reference。
• Shortcut 已含分片或验证时不重复拆步；已有 Base 新建完整表结构直接用 +table-bootstrap。
• 单产品线性任务直接执行，不创建 TodoWrite；只有跨产品或多个独立分支的长任务才建计划，并且只在阶段切换时更新，不在每条 CLI 后刷新状态。
• 用户要求资源名带当前时间戳时只取一次并在 Base、Table、Dashboard 等名称中复用同一值；不要为每个资源分别取时间。
• JSON 已返回所需字段时立即复用；不得为寻找同一字段改用 --verbose、raw、pretty 重复请求。
• 数据源创建前必须先 +datasource-list-sources 获取 processCode 等透传字段，不要凭记忆或猜测构造 sourceConfig。

记录输入与结果

• cells key 用当前 fieldId；大 JSON 用相对 --records-file。filters 顶层为 and|or，sort 使用 direction；复杂条件读 filter-sort。
• 建表字段类型使用真实枚举：单选为 singleSelect；人民币货币字段使用 type:"currency" 和 config:{"currencyType":"CNY","formatter":"FLOAT_2"}，不要猜 select 或 config.symbol。
• 用户限定返回字段时，先复用当前字段目录中的真实 fieldId，最终 +record-query 必须带 --field-ids <ID1,ID2>；工具层投影是业务要求和 token 控制的一部分，不能用最终答复二次过滤替代。
• 按真实字段类型写值，只读字段不得写入。
• 新建从 data.newRecordIds[] 取 ID，再用 +record-query --record-ids 回读；若用户同时限定列，回读命令一并传 --field-ids。
• 批量结果检查 completed/failed、verification、checkpoint；partial_success 不是完成。全量查询使用原子 record query --all 并检查 hasMore；只有 hasMore=false，或按指定 ID 全命中时，才声称结果完整。
• 写入效果未知时回读，不重放成功批次。

安全边界

• 删除不可逆，按 Runtime confirmation 核对真实目标；base list 只是最近访问。字段零/多候选、类型不明时停止；多批写保留已完成批次和续跑位置。
• 数据源 +datasource-create / +datasource-update 会触发真实数据同步（全量），执行前确认目标 Base 和 sourceConfig 无误。+datasource-sync 同理，单次最多 5 张表。

按需加载

每个 Case 最多读取一个操作 Reference。Golden Route 参数足够时读取零个并直接执行；一旦读取了一个 Reference，本 Case 不再读取第二个 Reference、通用 aitable.md、产品级 Catalog 或 Help。

通用 references/aitable.md 仅保留为兼容索引，不是默认入口；正常 Case 不预读。低频能力按意图选择一个最精确的 Reference，禁止连读。

错误最短路径

1. 零/多候选、字段歧义或分页不完整：停止并返回证据；需要后续页时只透传真实 nextCursor。
2. 类型错误只复核目标字段，不删字段或丢输入；partial_success 从 checkpoint 续跑，未知写入先回读。
3. 错误包含 actions / available_flags 时只执行其中的 next_command；同一操作最多做一次有证据的参数修正。retryable=false 或目标 ID 类型不符时停止，不把 Drive/Wiki/Space/子节点 ID 轮流代入试错。
4. 数据源同步 errorCode=4014 为幂等冲突（同步运行中重复触发），标记 FAILED 但可稍后重试；非数据源表（sync=false）触发 sync 会返回参数错误，先用 +base-get 确认 sync=true。

跨产品边界

• Excel 式单元格、区域和公式操作 → dingtalk-misc 的 Sheet。
• Base 作为整体在普通文件夹间移动或做外层存储重命名 → Drive；Base 结构复制/删除，以及 Base 内 Table、Dashboard、Section 的创建、复制、移动、重命名、删除 → AITable。
• 记录主键文档正文 → 取得真实 nodeId 后切 dingtalk-doc。