钉钉数字员工的自然语言创建、查询、修改、发布、删除、能力资源、执行状态、本地 Profile 落盘与 DSH 接入。Use when 用户说创建或管理数字员工、改人设/岗位/响应模式、发布或询问下线能力、查执行状态或 trace、管理数字员工 Skill/MCP、把已有数字员工转换为本地 Profile,或接入本地 DSH。命令前缀:dws dingtalk-tag。
89%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Low
Low-risk findings worth noting
执行任何 dws 操作前,先完整读取 dingtalk-shared。先用 dingtalk-tag-index.md 路由;生命周期读取 manage.md,自然语言创建/恢复/DSH 接入再读 manage-and-connect.md;能力资源读取 capability.md;执行排障读取 run.md。
自行管理任务执行与回复的接入方,可按 回复占位与流式 实现启动钩子和卡片更新。使用该流程需已安装 dingtalk-chat;按需安装时请同时选择该 Skill。DWS 直接托管本地 Agent 时,对已适配公开进度的 Agent,新连接默认发送 A2UI 占位并更新同一卡片,由运行时负责投递,模型不重复发卡;连接时指定 --reply-mode text 可只发最终文本。适配范围和首卡策略见 接入说明。
| 用户意图 | 命令 |
|---|---|
| 创建草稿 / 创建并发布 / 查询 / 修改 / 上线 / 删除 | dws dingtalk-tag manage ... |
| 下线 | 当前版本无独立下线命令;明确说明限制,不得用 delete 冒充下线 |
| A2A 或其他仅登录场景 | dws dingtalk-tag manage login --agent-uuid ... |
| 只登录数字员工并保存本地 Profile | dws dingtalk-tag manage login --agent-uuid ... |
| 把已有、已发布的本地数字员工接入 DSH | dws dingtalk-tag connect --agent-uuid ... --channel dsh |
| 把数字员工接入当前本地 Agent | dws dingtalk-tag connect --agent-uuid ... --channel auto --daemon --alwayson |
| 查询、停止或重启数字员工本地连接 | dws dingtalk-tag connect list/status/stop/restart |
| 在新机器接管(先在旧机器完成解绑) | 旧机器 connect unbind 成功后,新机器 dws dingtalk-tag connect --agent-uuid ... --channel ... |
| 解除本机连接,但保留员工和 Profile | dws dingtalk-tag connect unbind --agent-uuid ... |
| 将已有连接换为其他本地 Agent 或 DSH | 先 connect unbind --agent-uuid ...,再 connect --agent-uuid ... --channel ... |
| 创建、更新、删除或查询 Skill / MCP 资源 | `dws dingtalk-tag capability skill |
| 查一次执行的状态或完整 trace | dws dingtalk-tag run ... |
digitalTagEmployeeProfile.type,列表过滤使用顶层 type,仅支持 open_code、local_agent,a2a 暂不支持。CLI 参数为 --type;创建时必须显式传 --type open_code|local_agent,缺失或空值由 DWS 本地拦截;应告知调用方选择主程序类型,不能省略或发送空值。更新时未传则保持原值;明确接入本地 Agent/DSH 时传 --type local_agent。注意 create/list/save-draft 的 --type 是主程序类型,而 detail 使用 --snapshot draft|published 选择配置来源,不要混淆。--response-mode 或值为空,CLI 默认发送 mention_only,包括 local_agent。更新时不传就不更新该字段,显式值保持不变;最终有效配置由服务端按当前草稿校验。save-draft 只更新用户明确修改的基础草稿字段,不接受 Skill/MCP 完整数组。Skill/MCP 生命周期统一使用 capability skill|mcp create|update|delete|list|query;不设计 attach/detach,check_mcp 只在 create 和带配置的 update 内部调用。configString.mcpServers.<名称>.type(streamable-http 或 sse)以及对应 url;不能只填 URL,configType=JSON 也不能代替传输类型。仅更新 enabled 不重新提交配置。mention_only。历史草稿缺少响应模式时先通过 save-draft 补齐,不以发布命令隐式改写草稿。--yes。先用 --dry-run --format json 展示计划。agentUuid 和恢复命令;重试禁止再次执行 create。manage login;“创建并接入 DSH”则使用 connect --channel dsh。创建/发布与 connect 是独立事务,connect 绝不创建、修改或发布数字员工。agentUuid / --agent-uuid;人员标识统一使用 userId,不得要求或展示 uid、robotUid、staffId。--daemon --alwayson;命令行默认前台。DSH 不加这两个参数,由运行中的宿主员工级启动;宿主不可用时按 restartRequired 提示启动宿主。connect 不提供开机自启,也不能在电脑休眠期间处理消息。connect status 再恢复;不要重复 create、不要清除事件重试预算、不要隐式覆盖另一个 Adapter 的绑定。manage login。manage login 在内部完成 AuthCode 换票、在线身份核验,并保存精确 corpId:userId Profile;不得输出或转存 AuthCode/Token。只登录或仅保存 Profile 使用 manage login;真正接入本地 Agent/DSH 使用 connect。capabilities / binding 用于能力发现和绑定、访问判定。数字员工发送使用 chat +messages-reply / chat +messages-send,必须指定员工 Profile,并以 --body-stdin --wait-delivery --employee-context 传入受限正文与绑定上下文。DSH 要求 chatDelivery=true,缺少时提示升级 DWS。DingTalk-Real-AI/dingtalk-workspace-cli
52f38a4
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.