菜单
管理钉钉产品能力(AI表格/AI搜问/日历/通讯录/群聊与机器人/待办/审批/考勤/日志/DING消息/开放平台文档/钉钉文档/钉钉云盘/原生Markdown文件/AI听记/邮箱/在线电子表格/知识库等)。当用户需要操作表格数据、管理日程会议、模糊找人/查谁负责某事项、查询通讯录、管理群聊、机器人发消息、创建待办、提交审批、查看考勤、提交日报周报（钉钉日志模版）、读写钉钉文档、上传下载云盘文件、读取或修改原生.md文件、查询听记纪要、收发邮件、读写在线电子表格(axls)、管理钉钉知识库，或订阅个人 IM 事件、实时监听群成员加入、群成员退出、群改名和群解散时使用。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/crimsonblazezero/Zero-Tools --skill dws命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
领星 ERP 数据拉取、周报/月报汇总、运营周会 Excel 表格自动填报并交王祎审核确认后自动提交运营周复盘日志（附件以钉盘链接贴正文）、六组周会纪要自动生成与推送工作流。
Use when generating, pulling, auditing, filling, or rolling monthly business review reports (月度运营复盘/月报/主管月复盘/当月销售分析) for LingXing ERP and Nanjing Europe Group (南京欧洲组KS) Amazon stores.
Use when the user wants to pull Amazon sales/ad profit data from LingXing ERP (跨境电商ERP), build a weekly/monthly business dashboard (经营周报/月报/数据看板/排名环比/父ASIN), or send the report to a DingTalk group (钉钉群). Triggers: "拉上周数据/拉上个月数据", "父ASIN销售广告利润", "经营周报看板", "BSR排名环比", "发送到钉钉/欧洲群", "lingxing周报", "lingxing看板", "月报/月度复盘/全年完成表/退款率/退货率/仓储费/库销比". Pulls order-profit reports at parent-ASIN granularity, cross-validates ads spend, enriches Chinese product names, optionally fetches BSR rank trends, builds a self-contained Chart.js HTML dashboard (monthly variant adds fee-structure/rating/refund-rate/annual-target columns), and sends it to a specified DingTalk group via the dws CLI.
基于 SOC 职业分类
正在显示 SKILL.md
| name | dws |
| description | 管理钉钉产品能力(AI表格/AI搜问/日历/通讯录/群聊与机器人/待办/审批/考勤/日志/DING消息/开放平台文档/钉钉文档/钉钉云盘/原生Markdown文件/AI听记/邮箱/在线电子表格/知识库等)。当用户需要操作表格数据、管理日程会议、模糊找人/查谁负责某事项、查询通讯录、管理群聊、机器人发消息、创建待办、提交审批、查看考勤、提交日报周报（钉钉日志模版）、读写钉钉文档、上传下载云盘文件、读取或修改原生.md文件、查询听记纪要、收发邮件、读写在线电子表格(axls)、管理钉钉知识库，或订阅个人 IM 事件、实时监听群成员加入、群成员退出、群改名和群解散时使用。 |
| cli_version | >=1.0.15 |
通过 dws 命令管理钉钉产品能力。
⚠️ 命令可用性以当前 dws 二进制为准。服务发现已下线，本文档随内置 skill 发布；如果
dws <cmd> --help不存在，说明当前版本未暴露该命令。--help决定 Cobra 实际接受的 flags；公开基础命令和内建+shortcut 的 leaf Schema 决定 Agent 选择、参数映射/约束和安全确认语义。若命令存在但调用失败，请按错误中的 endpoint 或 tool 提示确认静态端点目录和后端工具注册。实际调用前可用dws <cmd> --help或--dry-run验证。
--format json 以获取可解析输出--yes 执行python scripts/<name>.py 已封装翻页/轮询/批量逻辑，遇到对应场景（如 AI 表格批量导入导出、AI 应用创建轮询、文档创建后写内容、钉盘目录树等）优先调用脚本而非手写多步命令。脚本均支持 --dry-run 预览、--format json 输出，失败时回退到手动步骤dws event consume ... --flatten 长连接，不要写脚本轮询消息历史shortcut 是对常用操作的高层封装，适合优先承担用户意图；产品参考文档和本 skill 负责判断意图、风险、跨产品流程和复杂参数，CLI 帮助负责声明当前版本真正可调用的命令。
dws <service> +<verb> ... --format json，不要手写等价的多步原子命令。dws schema --cli-path "<service> +<verb>" --format json 读取 Agent 选择、参数、跨参数约束、risk/confirmation 与接口语义；dws shortcut list --service <service> --format json 只作为轻量批量发现入口。dws <service> +<verb> --help 核对当前 Cobra 接受的 flags。父级 dws <service> --help 只能发现子命令，不能替代叶子参数帮助。confirmation=user_required 时，必须先获得用户确认，确认后才加 --yes；not_required 不额外确认。+ 命令。--verbose 复查；若仍失败，应记录具体输入、输出、trace / endpoint / tool 信息。下面统计当前公开 catalog 中的 shortcut。mono 模式不展开 200+ 行明细，避免 skill 过重；需要执行时先按产品路由，再用 dws shortcut list --service <service> --format json 读取参数、约束、风险和示例，最后用 dws <service> +<shortcut> --help 核对当前 Cobra flags。multi 模式的各产品 skill 会展开该产品的 shortcut 表。
| 服务 | shortcut 数 | multi skill | 发现命令 |
|---|---|---|---|
aitable | 29 | dingtalk-aitable | dws shortcut list --service aitable --format json |
attendance | 19 | dingtalk-misc | dws shortcut list --service attendance --format json |
calendar | 20 | dingtalk-calendar | dws shortcut list --service calendar --format json |
chat | 42 | dingtalk-chat | dws shortcut list --service chat --format json |
contact | 14 | dingtalk-contact | dws shortcut list --service contact --format json |
devapp | 19 | dingtalk-dev | dws shortcut list --service devapp --format json |
ding | 4 | dingtalk-misc | dws shortcut list --service ding --format json |
doc | 17 | dingtalk-doc | dws shortcut list --service doc --format json |
drive | 7 | dingtalk-drive | dws shortcut list --service drive --format json |
mail | 10 | dingtalk-mail | dws shortcut list --service mail --format json |
minutes | 6 | dingtalk-minutes | dws shortcut list --service minutes --format json |
dws profile list --format json 默认返回全部账号。自动化只使用每项稳定的 profile=corpId:userId；status/expiresAt/refreshExpAt 来自真实身份 Token，列表不触发刷新。corpId:userId、corpId:userName、corpName:userId、corpName:userName，也兼容单独的 corpId、唯一 corpName 和本地 profile 名。名称只用于输入；重名时必须按报错候选改用 corpId:userId。isOrgCurrent=true 账号。多账号组织没有默认账号时必须让用户指定账号；禁止选择第一项、最近登录或最近使用账号。--profile 使用全局 isCurrent=true 账号。primaryProfile/isPrimary 仅兼容输出，不参与选择；previousProfile 只用于 profile switch -。corpId 去重；每个组织使用唯一 isOrgCurrent=true 的 profile。组织存在多个账号且没有默认账号时先询问用户。写 / 发 / 删 / 撤回及持久切换前先确认目标组织和账号。| 产品 | 用途 | 参考文件 |
|---|---|---|
aiapp | AI应用：创建/查询/修改AI应用 | aiapp.md |
aisearch | AI搜问（通用找人首选）：按姓名/部门/职位/职责/上级/下级/手机号/工号维度找人，"谁负责 XX/XX 的负责人/某事项/某项目的人"统一走本产品；不含人才池/绩效/职业历程等专项 HR 场景（那些去 hrbrain） | aisearch.md |
aitable | AI表格：Base/数据表/字段/记录/视图/附件/图表/仪表盘/导入导出/模板搜索 | aitable.md |
attendance | 考勤：打卡结果/打卡流水/考勤组查询/考勤规则/汇总统计/假期类型/假期余额（P0 已落地，部分管理类命令仍属 P1） | attendance.md |
calendar | 日历：日历列表/日程/参与者/附件/响应/会议室/闲忙查询/时间建议 | calendar.md |
chat | 群聊与机器人：搜索群/建群/群成员管理/改群名/消息发送(文本/Markdown/图片/文件)/拉取消息/消息收藏/@我/特别关注/机器人群发/单聊/撤回/转发/引用回复/Webhook/机器人搜索 | chat.md |
contact | 通讯录：用户查询/部门/角色/花名册（学历/家庭/银行卡/紧急联系人/合同等基础字段）/离职员工/特别关注，以及创建企业、企业账号和邀请员工；不含职业历程/绩效/人才池（那些去 hrbrain） | contact.md |
devdoc | 开放平台文档：搜索开发文档 | devdoc.md |
ding | DING消息：发送/撤回（应用内/短信/电话） | ding.md |
doc | 钉钉文档：搜索/浏览/读写/块级编辑/评论/文件创建/复制/移动/重命名/删除/导出 docx/权限管理/媒体上传下载 | doc.md |
drive | 钉钉云盘：文件列表/元数据/文件夹/上传(两步)/下载 | drive.md |
hrbrain | 组织大脑：人才池管理/员工档案专项模块查询（元数据/批量数据/标签/职业历程/绩效）/结构化高级人才搜索（原始条件表达式）；区别于 contact 的基础通讯录档案与 aisearch 的通用语义找人 | hrbrain.md |
markdown | 原生 Markdown 文件：读取/创建/全量覆盖/字面量或 RE2 局部替换 |
用户提到"AI应用/创建应用/生成系统/做工具/管理后台/低代码" → aiapp
用户提到"目标管理/Agoal/战略解码/经营合约/计分卡/目标模板/周月报提交统计" → agoal
用户提到"找人/搜人/谁负责 XX/某事项的负责人/某项目的人/团队成员/上级/下级/按工号找人/按手机号找人" → aisearch（通用语义找人；若明确涉及人才池/绩效/职业历程/结构化高级条件，去 hrbrain）
用户提到"表格/多维表/AI表格/记录/数据/视图/图表/仪表盘" → aitable
用户提到"考勤/打卡/排班" → attendance
用户提到"日程/日历/会议室/约会/时间建议" → calendar
用户提到"群聊/建群/群成员/群管理/发消息/发图片消息/发文件消息/发 Markdown 消息/截图发钉钉/转发消息/引用回复/@我/特别关注消息/机器人发消息/Webhook/机器人群发/机器人单聊/通知" → chat
用户提到"通讯录/同事/部门/组织架构/子部门/部门多少人/离职员工/离职名单/离职花名册/花名册/基础员工档案(学历/家庭/银行卡/紧急联系人/合同)/角色/主管角色/管理员角色/财务/HR/特别关注/星标联系人/创建企业/企业账号/邀请员工/新员工入职" → contact（不含职业历程/绩效/人才池；那些去 hrbrain）
用户提到"开发/API/调用错误 文档" → devdoc
用户提到"DING/紧急消息/电话提醒" → ding
用户提到"钉钉文档/云文档/知识库/读写文档/块级编辑/文档评论/文档复制移动" → doc
用户提到"云盘/文件存储/文件上传下载/文件夹" → drive
用户提到"人才池/储备干部池/员工档案元数据或批量模块数据/职业历程/绩效记录/员工标签/组织大脑/结构化人才搜索(高级条件表达式)" → hrbrain（区别于 aisearch 的通用语义找人与 contact 的基础通讯录档案）
用户提到"原生 Markdown 文件/.md 文件/读取 Markdown 原文/覆盖 Markdown/局部替换 Markdown" → markdown
用户提到"听记/AI听记/会议纪要/转写/摘要/思维导图/发言人/热词" → minutes
用户提到"邮箱/邮件/发邮件/收邮件/搜邮件/查邮件/邮件草稿/转发邮件/回复邮件/邮件附件/抄送" → mail
用户提到"审批/请假/报销/出差/加班/同意/拒绝/撤销审批" → oa
用户提到"PAT 授权/行为权限/scope 授权/批量授权/一次性授权/会话授权/永久授权/授权浏览器策略" → pat
用户提到"日志/日报/周报/日志统计/写日报/提交周报/发日志/填日志" → report
用户提到"在线电子表格/钉钉表格/axls/工作表/单元格读写/合并单元格/筛选视图/导出 xlsx" → sheet
用户提到"待办/TODO/任务提醒/循环待办" → todo
用户提到"创建知识库/知识库列表/搜索知识库空间/wiki/团队空间/知识库成员管理/我的文档个人空间" → wiki
用户提到"监听有人@我/监听单聊或群消息/监听所有单聊或群消息/监听某人发送的消息/监听消息已读/监听消息撤回/监听消息贴表情或表情回应/监听群成员加入/监听群成员退出/监听群改名或群解散/订阅个人 IM 事件/实时接收钉钉事件/个人事件流/event consume user_im_message_*/监听并自动回复消息/驱动 Agent 处理消息" → event
事件监听中，同一目标、同一过滤条件的多个兼容事件优先生成一个 dws event consume <event_key> [event_key...] --flatten；不同用户、不同群或不同过滤条件拆成多个 consume 进程。
关键区分: aitable(数据表格) vs todo(待办任务) 关键区分: report(钉钉日志/日报周报) vs todo(待办任务) 关键区分: chat send-by-bot(机器人身份发消息) vs send-by-webhook(自定义机器人Webhook告警) 关键区分: doc(在线富文本文档/adoc) vs markdown(原生 .md 纯文本文件) vs drive(通用文件存储与传输) 关键区分: contact(基础通讯录档案：学历/家庭/银行卡/紧急联系人/合同/部门角色) vs aisearch person(通用语义找人：谁负责/上级/下级/多维度模糊搜索) vs hrbrain(人才池/员工档案专项模块数据/职业历程/绩效/结构化高级人才搜索) 关键区分: oa tasks(审批 taskId，审批/拒绝用) vs oa list-pending(收件箱 processInstanceId，查看用)
更多易混淆场景见 intent-guide.md
以下操作为不可逆或高影响操作，执行前必须先向用户展示操作摘要并获得明确同意，同意后才加 --yes 执行。
| 产品 | 命令 | 说明 |
|---|---|---|
aitable | base delete | 删除整个 AI 表格，含全部数据表和记录 |
aitable | table delete | 删除数据表（含全部字段/视图/记录） |
aitable | field delete | 删除字段（该列所有值同步清空） |
aitable | view delete | 删除视图 |
aitable | record delete | 删除记录（支持批量） |
aitable | chart delete / dashboard delete | 删除图表/仪表盘 |
calendar | event delete | 删除日程，所有参与者同步取消 |
calendar | participant delete | 移除日程参与者 |
calendar | room delete | 取消会议室预定 |
chat | group members remove | 移除群成员 |
chat | message recall-by-bot | 撤回机器人已发消息 |
doc | delete | 删除整篇文档/文件到回收站（与 block delete 不同，本命令删除整个 node） |
doc | block delete | 删除文档单个块（不可恢复） |
doc | permission update | 修改协作者权限（降权可能影响他人访问） |
ding | message recall | 撤回已发 DING 消息 |
oa | approval revoke | 撤销自己发起的审批实例 |
oa | approval reject | 拒绝待审批（需加明确理由） |
Step 1 → 展示操作摘要（操作类型 + 目标对象 + 影响范围）
Step 2 → 用户明确回复确认（如 "确认" / "好的"）
Step 3 → 加 --yes 执行命令
作为一个智能助手，你的首要任务是理解用户的真实、完整的意图，而不是简单地执行命令。在选择 dws 的产品命令前，必须严格遵循以下四步流程：
alidocs.dingtalk.com URL 时，该域名下存在多种路径格式（/i/nodes/...、/i/p/...、/spreadsheetv2/...、/document/edit|preview?dentryKey=... 等），每种的处理流程不同。必须先读取 url-patterns.md 中的「alidocs URL 分流决策」，按其中规则识别 URL 类型后再选择对应产品。含 shanji.dingtalk.com URL 时直接路由到 minutes。URL 已识别后直接进入对应产品流程，无需后续步骤。dws schema 内嵌当前二进制公开命令面的结构化契约。Agent 选择命令、读取参数映射/约束和安全语义时必须优先渐进查询 leaf Schema；真正组装执行参数前，用 --help 确认当前 Cobra 接受的 flags：
本节同时适用于基础/原子命令与公开内建 + shortcut。用户自定义或未公开 shortcut 不进入发布 Schema；其是否可执行仍以当前 Cobra help 为准。
稳定 command identity、主 CLI path 和 alias 已在构建时由 reviewed registry 与真实 Cobra tree 精确绑定。Agent 不应读取 Catalog 文件、native annotation 或其他生成 JSON 来重新推断命令；所有运行时查询都以当前二进制交付的 Schema 投影为准。
# 第 1 层：产品概览（~4.5KB，列出全部产品 + 工具数 + 用途摘要）
dws schema
# 第 2 层：产品级（列出该产品下全部工具的 cli_path + description + effect/risk）
dws schema calendar
# 第 3 层：分组级（按命令分组列出工具摘要）
dws schema "calendar event"
# 第 4 层：完整 leaf（参数契约：type/required/description/constraints/examples）
dws schema "calendar event create"
# --compact：当前支持；去除 provenance/debug 字段，仅保留 Agent 选参所需
dws schema "calendar event create" --compact
# --all：导出所有工具的完整 leaf Schema，仅用于 CI / 审计 / 参数 baseline
dws schema --all --format json
--all 使用边界（强制）：--all 会返回每个工具的完整参数、约束和安全语义，输出体积很大。仅在用户明确要求全量导出，或执行 CI、Catalog 审计、参数防丢 baseline 时使用。普通业务任务严禁使用 --all 做命令发现，也不要把全量结果直接注入 Agent 上下文；必须按“产品概览 → 产品/分组 → leaf”渐进查询。完整兼容性 baseline 必须使用未裁剪的 schema --all；schema --all --compact 会移除 provenance 和接口映射字段，不得作为完整 baseline。
同一个工具的 leaf 查询与 --all 条目是同一份 ToolSpec 契约的投影，参数、安全和接口语义必须一致。Alias 查询只改变路径视图；不得根据 alias 重写或补猜参数。若观察到内容差异，应作为契约漂移报告，而不是选择其中一份继续执行。
--compact 模式去掉的字段：agent_metadata_source、agent_source_refs、agent_summary_source、effect_source、metadata_source、interface_ref、interface_description、property、primary_cli_path、parameter_count 等 provenance/debug 字段。保留的字段：cli_path、canonical_path、description、effect、risk、confirmation、interface_mode、availability、interface_reason、parameters（含 type/required/description/default/enum）、constraints、examples、use_when、avoid_when。
--compact 是 Schema 展示能力。当前版本支持；若兼容旧二进制时收到 unknown_flag: --compact，仅去掉 --compact 重跑同一个 Schema 查询。不要因此判定 leaf 不存在，也不要改用 Schema 查询业务数据。
// leaf 级输出（dws schema "calendar event create" --compact）
{
"cli_path": "calendar event create",
"canonical_path": "calendar.create_calendar_event",
"description": "创建新的日程...",
"effect": "write", // read | write | destructive
"risk": "medium", // low | medium | high
"confirmation": "not_required", // not_required | user_required
"interface_mode": "mcp", // mcp | local | composite
"availability": "available", // available | unavailable
"interface_reason": "",
"parameters": {
"title": { "type": "string", "required"
confirmation=user_required → 必须先向用户确认再加 --yes；不要根据 effect 或 risk 的值自行重写最终 confirmation winneravailability=unavailable → 不执行该工具；向用户说明 interface_reason。interface_mode 只描述实现机制，不能覆盖 availabilityparameters.<flag>.required=true → Agent 应提供该参数；Cobra 是否硬拒绝以 --help/实际命令契约为准parameters.<flag>.cli_required=true → Cobra 将该 flag 标记为硬必填constraints.require_together → 列出的 flag 必须同时提供| 信息 | 事实源 |
|---|---|
| 命令是否存在、当前 Cobra 接受哪些 flags | dws <cli_path> --help |
| Agent 选择、参数映射/required/组合约束、risk/confirmation（原子/基础命令） | dws schema "<cli_path>"（按需加 --compact） |
| shortcut 的参数、组合约束、risk/confirmation、示例 | dws shortcut list --service <service> --format json |
| 人类可读用法 | dws <cli_path> --help |
| 钉钉中的文档、文件、日程、消息等实际数据 | 真正执行对应的 read / search / list 命令 |
Schema 与 Help 冲突是契约漂移，不得静默猜测或把两边字段随意拼接：
dws schema 只查询命令契约，不搜索钉钉文档或业务数据。完成命令发现后，必须继续执行真实命令，例如 dws doc read、dws drive search；不要把 Schema 查询结果当成业务查询结果。
dev.* 包含 helper-only 执行面，其中远端 helper 未进入 pinned metadata 时标记为 composite，不能伪装成 local。event list / event schema 读取内置目录和 payload 定义，属于 local；event consume / event status / event stop 同时编排远端个人订阅控制面与本地 bus/consume，属于 composite。实现来源不同，不改变统一查询边界：进入全局 dws schema 的命令必须先进入 reviewed CommandRegistry，并由同一 ToolSpec 投影到 leaf、产品/分组、--all 与 Catalog。不得在查询时重新调用 MCP tools/list，也不得把 Cobra 临时合成结果作为第二条 Schema 数据路径。
事件需要区分两种 Schema：dws event schema <event_key> --flatten 查询 Agent 要消费的顶层业务字段；dws schema "event consume" 查询 CLI 命令参数。前者是真实业务命令，后者只读取最终内嵌 SchemaRegistry；不能相互替代。
source 表示最终命令 identity 的来源，不表示运行时 backing；helper/local/MCP 实现机制读取 interface_mode、availability 和 provenance，不要假定 dev.* 必然是 source=mcp:<server>，也不要假定本地命令必然是 source=cobra。
--verbose 重试一次RECOVERY_EVENT_ID=<event_id>，优先按 recovery-guide.md 执行 recovery 闭环--help 为准；公开基础命令与内建 shortcut 的 Agent 映射/约束/安全语义以 leaf Schema 为准）document/edit|preview?dentryKey= 链接）RECOVERY_EVENT_ID、execute/finalize 规范oa | 7 | dingtalk-misc | dws shortcut list --service oa --format json |
report | 2 | dingtalk-misc | dws shortcut list --service report --format json |
sheet | 2 | dingtalk-misc | dws shortcut list --service sheet --format json |
todo | 11 | dingtalk-todo | dws shortcut list --service todo --format json |
wiki | 1 | dingtalk-wiki | dws shortcut list --service wiki --format json |
| markdown.md |
minutes | AI听记：听记列表/摘要/关键词/转写/待办/思维导图/发言人/发言人段落总结/热词/录音控制/成员权限/上传 | minutes.md |
oa | OA审批：待处理/详情/同意/拒绝/撤销/记录/已发起/任务/转交/评论/抄送 | oa.md |
pat | PAT 行为授权：浏览器策略/scope 预览/一次性、会话或永久授权 | pat.md |
report | 日志：按模版创建/收件箱/已发送/模版查看/详情/已读统计 | report.md |
mail | 邮箱：邮箱地址查询/邮件搜索(KQL)/邮件详情/发送邮件 | mail.md |
sheet | 在线电子表格(axls)：工作表 CRUD/区域读写/CSV 批量写入/行列增删/合并/查找替换/筛选视图/全局筛选/排序/下拉列表/条件格式/浮动图片/浮动图表/模板/导出 xlsx(单命令一站式) | sheet.md |
todo | 待办：创建(含优先级/截止时间/循环)/查询/修改/标记完成/删除 | todo.md |
wiki | 知识库：空间创建/详情/列表/搜索 + 成员管理 | wiki.md |
event | 个人 IM 事件：监听消息接收、指定发送人、已读、撤回、表情回应，NDJSON 输出（实时驱动 Agent） | event.md |
todo |
task delete |
| 删除待办 |
minutes | replace-text | 全文批量替换转写与摘要 |