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/best_practices/06-data-analytics.md
View on GitHub# 数据分析
> 本场景所有 recipe 均为 full。
| Recipe | 行动指南(固定路线) |
|--------|-------------------|
| read-aitable | 1. `aitable base search --query "<表格名>"` → 取 `baseId`/`tableId`<br>2. **按结果类型分流**:<br> • 原始记录筛选、排序、Top N、预览或字段投影 → `aitable record query --limit 30 [--filters ...] [--sort ...]`<br> • 单表直接标量、分组或去重统计 → `aitable record stats` / `aitable record group-stats`<br> • 同 Base JOIN、字段间算术、CASE、聚合后派生、汇总结果 Top N 或排名、窗口计算 → 读 `aitable-psql.md`,固定同一 DWS 入口,按 `psql -l` → `psql -t` → `LIMIT 3` 最小查询 → 正式 SQL 在服务端完成<br> • 已获用户明确许可的完整逐行明细或逐条业务操作(不做分析)→ `aitable field get` 取必要 `fieldId`,再服务端过滤的 `aitable record query --all --page-limit 0 --field-ids ...`;不需要也不触发 psql 降级门禁<br> • 完整导出 → `aitable export data`<br>3. 使用 record query 时检查 `hasMore/complete/partial`;使用 psql 时检查返回行数与截断提示;不得把任何原始记录用于本地等价分析<br>4. 总结数据 |
| generate-data-report | 1. 原始记录筛选、排序和 Top N 使用 `record query`;单表直接标量、分组或去重统计使用 `record stats` / `record group-stats`;JOIN、字段间算术、CASE、聚合后派生、汇总结果排名和窗口计算使用 `aitable psql` 在服务端完成;禁止 `record query --all` 后以 Python、jq、JavaScript、电子表格或 Agent context 计算<br>2. 按业务主题规划少量查询:同粒度、同关联链合并;不同事实粒度或不同业务主题拆分;关键复杂结论另用服务端 SQL 复核<br>3. 选用 psql 后失败,先按客户端/宿主、网络/认证/权限或 SQL/函数限制分类修复并重试;不得降级为全量记录读取<br>4. 本地工具仅可格式化、绘图或合并少量服务端汇总结果,不能代替服务端计算;随后 `doc create --name "<报告名>" --content "<分析报告>"` |
| create-aitable-record | **写入路径分流**(关键决策):<br> • **追加到已有表**(场景:把这批数据加到「成员表」)→ `python3 scripts/import_records.py <baseId> <tableId> data.csv\|data.json [batch_size]`(走 `record create`,需要列名匹配字段名)<br> • **新建表**(场景:把这个 Excel 变成多维表)→ `dws aitable +import-file --base-id <baseId> --file <file>`(DWS 内置 prepare→OSS PUT→import data 全流程和正确的头处理,**禁止自己写 PUT**);首次调用会触发确认门,取得明确确认后由执行方在同一命令追加 `--yes`。注意 `aitable import upload` 没有 `--file` flag、也不代做 PUT,只准备导入;能一站式完成的是 `+import-file`<br> • **单条/少量手动**:1. `aitable base search` → `baseId`/`tableId`;2. `aitable field get` → `fieldId` 与类型;3. `aitable record create --records '[{"cells":{"<fieldId>":"值"}}]'` |
| update-aitable-record | 1. `aitable base search --query "<表格名>"` → 取 `baseId`/`tableId`<br>2. **取目标 record**:<br> • 已知少量 recordId → `aitable record query --record-ids <ID1,ID2>`<br> • 按条件批量改 → `aitable record query --base-id <baseId> --table-id <tableId> --filters '<JSON>' --all`(**用 --all 防止漏改**)<br>3. **先展示让用户确认要改的 record 列表**<br>4. `aitable record update --base-id <baseId> --table-id <tableId> --records '[{"recordId":"<recordId>","cells":{...}}]'`(建议 ≤30,硬上限 100) |
| search-aitable-template | 1. `aitable template search --query "<关键词>"` → 取 `templateId`<br>2. 用户选定<br>3. `aitable base create --name "<表格名>" --template-id <templateId>` → 取 `baseId` |
| export-aitable-to-xlsx | 1. `aitable base search --query "<表格名>"` → 取 `baseId`<br>2. **主路径**:`python3 scripts/aitable_export_via_task.py <baseId> --scope all\|table\|view`(脚本内置轮询 + 自动下载;多 base 批量 / 按视图组合等复杂场景同样走它)<br>3. **手动路径**(单次导出):`aitable export data --base-id <baseId> --scope all --export-format excel_and_attachment`(全表+附件);单表(仅 xlsx)→ `--scope table --table-id <tableId> --export-format excel`;单视图 → `--scope view --table-id <tableId> --view-id <viewId>`<br>4. 大表超时:`export data` 的单次等待窗口只有 `--timeout-ms`(默认且上限 30000 = 30 秒,没有 `--timeout-sec`,传了会报 unknown flag);窗口内没跑完会返回 `taskId`,用 `aitable export data --task-id <ID>` 反复续等,拿到 `downloadUrl` 后 `curl -L "<downloadUrl>" -o <文件名>` 下载(`export data` 不提供 `--output` 落盘 flag——`--output` 只是 `doc export` 等个别命令的局部参数;导出内容一律经 `downloadUrl` 下载,见 [aitable-export-import.md](../products/aitable/aitable-export-import.md)) |
| primary-doc-from-record | 当 AI 表格用文档作主键字段时,从 record 跳到其主文档:<br>1. `aitable record query` 取 `recordId`<br>2. `aitable base get-primary-doc-id --base-id <baseId> --table-id <tableId> --record-id <recordId>` → 取主键文档 `dentryUuid`<br>3. 凭 `dentryUuid` 调 `doc read --node <UUID>` 拿文档内容 |
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 |