@zhin.js/adapter-dingtalk 1.0.60 → 1.0.61

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @zhin.js/adapter-dingtalk
 
+## 1.0.61
+
+### Patch Changes
+
+- f1e9a76: fix: 提高 skill 质量
+  - zhin.js@1.0.73
+  - @zhin.js/http@1.0.66
+
 ## 1.0.60
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-dingtalk",
-  "version": "1.0.60",
+  "version": "1.0.61",
   "description": "Zhin.js adapter for DingTalk (钉钉)",
   "type": "module",
   "main": "./lib/index.js",
@@ -36,11 +36,11 @@
     "@types/koa": "^2.15.0",
     "@types/node": "^25.6.0",
     "typescript": "^6.0.3",
-    "zhin.js": "1.0.72"
+    "zhin.js": "1.0.73"
   },
   "peerDependencies": {
-    "@zhin.js/http": "1.0.65",
-    "zhin.js": "1.0.72"
+    "@zhin.js/http": "1.0.66",
+    "zhin.js": "1.0.73"
   },
   "peerDependenciesMeta": {
     "@zhin.js/http": {

package/skills/dingtalk/SKILL.md

@@ -2,7 +2,11 @@
 name: dingtalk
 platforms:
   - dingtalk
-description: 钉钉平台管理：群管理（踢人、改群名、查群信息）、组织架构（部门/用户查询）、工作通知、群聊创建与管理。仅有昵称时请先 list_members 获取 user_id 再操作。
+description: >-
+  钉钉平台管理能力。当用户在钉钉中请求群管理（踢人、改群名、查群信息）、
+  组织架构查询（部门/用户查询）、发送工作通知、创建或管理群聊时使用。
+  即使用户没有提到钉钉，只要上下文是钉钉/DingTalk 场景且涉及群管理、
+  组织架构或工作通知，就应触发。仅有昵称时先查部门用户列表获取 user_id。
 keywords:
   - dingtalk
   - 钉钉
@@ -11,6 +15,7 @@ keywords:
   - 部门
   - 工作通知
   - 组织架构
+  - 企业
   - list_members
 tags:
   - group
@@ -18,7 +23,6 @@ tags:
   - im
   - enterprise
 tools:
-  # 平台特有工具
   - dingtalk_get_user
   - dingtalk_get_dept_users
   - dingtalk_list_departments
@@ -27,38 +31,61 @@ tools:
   - dingtalk_add_chat_members
   - dingtalk_dept_info
   - dingtalk_update_chat
-  # 通用群管工具
   - dingtalk_kick_member
   - dingtalk_set_group_name
   - dingtalk_get_group_info
 ---
 
-## 工具概览
+# 钉钉群聊与组织管理技能
 
-### 平台特有
+钉钉是企业 IM 平台，特有组织架构（部门树）和工作通知能力，区别于个人社交类 IM。
 
-| 工具 | 说明 | 权限 |
+## 核心原则
+
+### 组织架构是核心
+
+钉钉的用户隶属于部门树，很多操作需要从组织架构出发：
+```
+dingtalk_list_departments → 获取部门列表（根部门 ID=1）
+dingtalk_get_dept_users(dept_id) → 获取部门下的用户列表
+dingtalk_get_user(user_id) → 获取用户详情
+```
+
+### 工作通知 ≠ 群消息
+
+`dingtalk_send_work_notice` 是直接发给个人的企业通知，出现在钉钉的「工作通知」入口，不需要群聊。用户说「通知一下张三」，如果是正式的企业通知，用 `send_work_notice`；如果只是聊天消息，用普通消息发送。
+
+## 工具分类
+
+### 群聊管理
+
+| 工具 | 用途 | 说明 |
+|------|------|------|
+| `dingtalk_kick_member` | 踢出成员 | — |
+| `dingtalk_set_group_name` | 改群名 | — |
+| `dingtalk_get_group_info` | 群信息 | — |
+| `dingtalk_create_chat` | 创建群聊 | 需群主 userId + 至少一个成员 |
+| `dingtalk_add_chat_members` | 添加成员 | — |
+| `dingtalk_update_chat` | 更新群设置 | 改名、换群主、增减成员 |
+
+### 组织架构
+
+| 工具 | 用途 | 说明 |
 |------|------|------|
-| `dingtalk_get_user` | 获取用户信息 | user |
-| `dingtalk_get_dept_users` | 获取部门用户列表 | user |
-| `dingtalk_list_departments` | 获取部门列表 | user |
-| `dingtalk_dept_info` | 获取部门详细信息 | user |
-| `dingtalk_send_work_notice` | 发送工作通知 | group_admin |
-| `dingtalk_create_chat` | 创建群聊 | group_admin |
-| `dingtalk_add_chat_members` | 向群聊添加成员 | group_admin |
-| `dingtalk_update_chat` | 更新群聊设置（改名、换群主、增减成员） | group_admin |
-
-### 通用群管
-
-| 工具 | 说明 | 权限 |
+| `dingtalk_list_departments` | 部门列表 | 默认从根部门 ID=1 开始 |
+| `dingtalk_dept_info` | 部门详情 | — |
+| `dingtalk_get_dept_users` | 部门用户列表 | — |
+| `dingtalk_get_user` | 用户详情 | — |
+
+### 通知
+
+| 工具 | 用途 | 说明 |
 |------|------|------|
-| `dingtalk_kick_member` | 踢出成员 | group_admin |
-| `dingtalk_set_group_name` | 修改群名称 | group_admin |
-| `dingtalk_get_group_info` | 获取群信息 | user |
+| `dingtalk_send_work_notice` | 工作通知 | 发给指定用户列表，不需要群 |
 
-## 执行规则
+## 易错点
 
-1. 操作成员时需要 `user_id`，仅有昵称时先调 `dingtalk_get_dept_users` 或 `dingtalk_get_group_info` 获取
-2. 部门查询默认从根部门 ID=1 开始
-3. 群聊创建需要群主 userId 和至少一个成员
-4. 工作通知发送给指定用户列表，不依赖群聊
+1. **部门查询从根部门 ID=1 开始**。不知道部门 ID 时先 `list_departments` 获取整棵部门树。
+2. **群聊创建需要群主 userId 和至少一个成员**，不能创建空群。
+3. **工作通知是独立于群聊的**，它发到个人的钉钉「工作通知」入口，不要与群消息混淆。
+4. **操作成员需要钉钉 userId**，仅有昵称时先通过 `get_dept_users` 或 `get_group_info` 查找。