Menu
dws 多 skill 模式的公共参考——认证、全局参数、Schema 命令发现、多组织 / --profile 规则、安全底线。所有 dingtalk-* 子 skill 执行前先读本 skill。命令前缀：dws。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | dws-shared |
| description | dws 多 skill 模式的公共参考——认证、全局参数、Schema 命令发现、多组织 / --profile 规则、安全底线。所有 dingtalk-* 子 skill 执行前先读本 skill。命令前缀：dws。 |
| cli_version | >=1.0.40 |
| metadata | {"category":"productivity","stability":"experimental","requires":{"bins":["dws"]}} |
🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准；生产 / 共享环境请优先使用 mono 模式（
dws skill setup --mode mono）。
每个 dingtalk-* 子 skill 都把本 skill 列为 PREREQUISITE：执行任何产品命令前先读这里的认证、全局参数、Schema 命令发现与多组织规则。dws 必须在 PATH 上。
dws auth login（新账号新增 profile，同一 corpId + userId 重登只刷新该账号）；--device 无头 / SSH 登录dws auth status [--profile <selector>] 查看组织当前账号或指定账号；会尝试刷新，失败时保留真实错误ciphertext_key_mismatch 且普通终端仍可登录时：先运行 env -u DWS_DISABLE_KEYCHAIN dws auth migrate-keychain --to file-dek --dry-run --format json，通过后加 --yes 迁移；不要直接 auth reset--format json 取可解析输出--profile <selector>：支持 corpId:userId、corpId:userName、corpName:userId、corpName:userName，也兼容单独的 corpId、唯一 corpName 和本地 profile 名；均不改默认 profileconfirmation 为准：user_required 才先确认并在同意后加 --yes；not_required 不得仅因 effect=write 自行升级确认要求选择命令、读取参数映射/组合约束与安全语义时，优先渐进查询当前二进制内嵌的 leaf Schema；真正组装参数前，用 --help 确认 Cobra 当前接受的 flags：
本节适用于进入 Runtime Schema 的基础/原子命令。+ shortcut 是明确例外，使用下方独立 shortcut catalog 契约。
dws schema # 产品概览
dws schema calendar # 产品工具列表
dws schema "calendar event" # 命令分组
dws schema "calendar event create" --compact # 完整 leaf 契约
--all 会导出全部工具的完整 leaf，输出很大。仅在用户明确要求全量导出，或执行 CI、Catalog 审计、参数防丢 baseline 时使用 dws schema --all --format json；普通业务任务必须渐进查询，不得把全量结果注入上下文。完整 baseline 不得使用会裁剪 provenance 的 --all --compact。
| 要确认的信息 | 事实源 |
|---|---|
| 命令是否存在、Cobra 接受哪些 flags | dws <cli_path> --help |
| Agent 选命令、参数映射/约束、risk/confirmation（原子/基础命令） | dws schema "<cli_path>" |
| shortcut 的参数、约束、risk/confirmation、示例 | dws shortcut list --service <service> --format json |
| 钉钉中的文档、日程、消息等业务数据 | 真正执行对应的 read / search / list 命令 |
Schema 与 Help 冲突属于契约漂移：参数只用 Help 接受的 flags，并报告漂移；安全语义冲突时采用更保守的确认方式。Schema 只描述命令契约，不能替代业务查询。
shortcut 是对常用操作的高层封装。先按产品 skill 的意图表、脚本和 recipe 路由：存在精确覆盖场景的专用脚本/recipe 时按其执行；否则可见 shortcut 优先于手写等价原子流程。dws shortcut list --service <service> --format json 读取 flags、required/enum、跨参数 constraints、risk/confirmation 和 examples；不要对 + 路径调用 dws schema。dws <service> +<verb> --help 核对 Cobra 接受的 flags；父级 dws <service> --help 只能用于发现子命令。confirmation=user_required 时先获得用户确认，确认后才加 --yes；not_required 不额外确认。+ 命令。dws 可同时登录多个钉钉账号，同一组织也可保留多个账号。一个 profile 由 corpId + userId 唯一确定；dws profile list --format json 默认显示全部账号，稳定选择器读取每项 profile。
profile=corpId:userId。名称重名时按报错候选改用稳定选择器，不得猜测。isOrgCurrent=true 的账号。多账号组织没有默认账号时先让用户指定账号；禁止选择第一项、最近登录或最近使用账号。corpId 去重后有 ≥2 个组织时，每个组织使用唯一组织默认账号的 profile 各搜一遍。禁止把同组织多个账号重复执行。profile。--profile 跨组织写时先与用户确认目标组织；持久切换 dws profile switch（改默认组织）属写操作，未经用户明确要求不得执行。dingtalk-profile skill。unknown command / unknown flag：先跑 dws <path> --help 查证再修正一次，别把自然语言当命令 / flagdws auth login 重新登录；本地密钥不匹配按上面的 macOS 迁移流程处理，不要混为 token 过期dws devdoc article search --query "<关键词>" --format json 查官方文档，不编造原因管理钉钉产品能力(AI表格/AI搜问/日历/通讯录/群聊与机器人/待办/审批/考勤/日志/DING消息/开放平台文档/钉钉文档/钉钉云盘/AI听记/邮箱/在线电子表格/知识库等)。当用户需要操作表格数据、管理日程会议、模糊找人/查谁负责某事项、查询通讯录、管理群聊、机器人发消息、创建待办、提交审批、查看考勤、提交日报周报（钉钉日志模版）、读写钉钉文档、上传下载云盘文件、查询听记纪要、收发邮件、读写在线电子表格(axls)、管理钉钉知识库时使用。
钉钉个人 IM 事件长连接监听、订阅与消费，覆盖消息接收、指定发送人、已读、撤回和表情回应，输出 NDJSON 到 stdout。Use when 用户提到 监听个人消息事件、被@消息、监听单聊或群消息、监听某人发送的消息、监听消息已读、监听消息撤回、监听消息贴表情或表情回应、实时接收钉钉事件、用事件驱动 Agent。命令前缀：dws event。
钉钉多组织 / profile 管理与跨组织取数。Use when 用户说 切换组织/换组织/跨组织/另一个钉钉/别的公司/多组织/看登录了哪些组织/profile，或在当前组织找不到群/人/数据需要去其他组织找。命令前缀：dws profile / dws auth / 全局 --profile。
钉钉通讯录查询与组织管理（用户、部门、角色、花名册、离职员工、创建企业、企业账号、邀请员工）。Use when 用户说 查部门/我的信息/按 userId 查/离职员工/创建企业/企业账号/邀请员工。Distinct from dingtalk-aisearch(模糊搜人首选：找同事/查上下级/谁负责)。命令前缀：dws contact。
钉钉开放平台企业内部应用管理：应用查询/创建/修改/删除/停启、凭证、权限点、成员、安全配置、网页应用、机器人、版本发布。Use when 用户说 开发者后台应用/开放平台应用/企业内部应用/agentId/clientId/appKey/appSecret/customKey/应用权限/权限点/scopeValue/创建机器人/智能体机器人/机器人配置/机器人回调/IP白名单/登录重定向/端内免登/应用版本/版本发布/发布审核/选审批人/把机器人接到本地调试/connect。
钉钉 AI 表格（多维表）。Use when 用户说 AI表格/多维表/数据表/base/table/建表/查记录/写数据/字段/记录增删改查/筛选/排序/公式/模板搜索/批量导入CSV或JSON/导出/仪表盘/图表/上传附件到表格/按字段类型建表。Distinct from 主 dws skill 的 dws sheet(电子表格/单元格读写/公式)、dws doc(文档编辑)。命令前缀：dws aitable。