Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/dingtalk-skills/dws
dws
Unverified【何时用:仅当用户明确指向钉钉/DingTalk(钉钉文档、钉钉日程等)时使用;泛指做文档/表格/待办/审批默认走本地工具,不要误用钉钉】用 dws CLI 管理钉钉:AI表格/AI搜问(找人首选)/目标管理(Agoal)/组织大脑/日历/通讯录/群聊与机器人消息/待办/审批/智能合同/考勤/日志(日报周报)/DING消息/钉钉文档/云盘/Markdown文件/HTML文件/AI听记/邮箱/在线电子表格(axls)/知识库/白板/开放平台文档/个人IM与OA事件订阅。用户要求操作上述钉钉产品时使用。
references/products/aitable/aitable-best-practices.md
View on GitHub# AI 表格最佳实践
## 1. 记录单元格可写性分类
| 字段类型 | 可写 | 正确方式 |
|----------|------|----------|
| 文本/数字/日期/单选/多选/复选框/URL | ✅ | record create/update |
| 附件 | ✅ | 本地文件上传获取 fileToken;在线 URL 可直接写入,见 [附件流程](./aitable-attachment.md) |
| 创建人/修改人/创建时间/修改时间 | ❌ | 系统字段,只读 |
| 公式/查找引用 | ❌ | 单元格只读,由系统计算;字段定义能否创建/更新以当前 leaf Schema 为准 |
| AI 字段 | ❌ | 只读,由 AI 自动计算 |
## 2. 查询执行契约与任务选路
四条要点:优先 `--filters` 在服务端过滤,不要拉全量后在 context 里手动统计;`has_more=true` 时数据可能不完整,禁止下全局结论;字段名(fieldId)必须来自 `table get` 真实返回,不要猜测;全量导出为文件走 `export data`(脚本 `aitable_export_via_task.py`),不要 `--all` 拉全量再写文件。查询细则(`--all`/`--page-limit`/filters 写法)见 [aitable-record-query.md](./aitable-record-query.md),分析任务选路见 [aitable-data-analysis-sop.md](./aitable-data-analysis-sop.md)。
## 4. 创建/修改后回读确认
执行写操作后,必须使用独立读取立即回读确认结果;不能用 mutation 回执、HTTP 200 或退出码 0 代替。
| 写操作 | 必须回读命令 | 确认内容 |
|--------|-------------|----------|
| `table create` | `table get --table-ids <新tableId>` | 表名、字段列表是否符合预期 |
| `field create` | `table get --table-ids <tableId>` | 新字段是否出现在字段列表中 |
| `record create/update` | `record query --record-ids <新recordId>` | 写入值是否正确 |
## 5. AI 字段注意事项
- AI 字段的 prompt **必须至少包含一个 `fieldRef` 引用**,纯文本 prompt 会被后端拒绝
- 先创建/确认被引用字段的 fieldId,再在 prompt 中引用
- `outputType` 必须与字段类型一致(如 `outputType=text` 配 `--type text`)
## 6. DWS 与 MCP 交互契约
1. **Schema 优先** — 先读精确 leaf Runtime Schema,任务内按 canonical leaf path 缓存。只有 Schema 不足或与实际结果冲突时才读 leaf Help;版本、profile 变化或出现契约错误时废弃缓存。
2. **写后缓存失效** — mutation 返回真实 ID/名称后立即更新对象索引,清除受影响对象、Table、Dashboard 及相关查询缓存。写后验证不得复用写前数据。
3. **独立回读** — 创建/更新返回可能带旧名称或旧配置。使用真实 ID、recordId 或唯一键再读取,比较业务值和 JSON 类型;删除操作必须证明对象已不存在。
4. **未知写入不重放** — 写调用超时、断连或回执不完整时,副作用可能已发生。先用最小只读范围查真实状态,不原样自动重放创建、更新、删除或导入。
5. **并发有边界** — 同一 Base 的写入默认串行;无依赖只读默认最多 4 路并发。只有不同 Base、无数据/ID/顺序依赖且失败可独立回读时,才允许受控并发写。
6. **信封需归一化** — 按“合法 `ok/outcome` → 已知旧 `status` → JSON boolean `success`”判断,不假设固定 `data` 层。`partial_failure` 可在 stdout 并使用退出码 7;先解析 stdout/stderr 中的结构化信封,再处理退出码。
7. **上传凭据必须脱敏** — `uploadUrl`、token、authorization、signature、secret 不能输出或记录;错误对象、嵌套 `data/result` 和字符串内 URL 都要递归脱敏。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |