@zhin.js/adapter-kook 1.0.75 → 1.0.76

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @zhin.js/adapter-kook
 
+## 1.0.76
+
+### Patch Changes
+
+- f1e9a76: fix: 提高 skill 质量
+  - zhin.js@1.0.73
+  - @zhin.js/logger@0.1.55
+  - @zhin.js/console@2.0.16
+  - @zhin.js/http@1.0.66
+
 ## 1.0.75
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-kook",
-  "version": "1.0.75",
+  "version": "1.0.76",
   "description": "Zhin.js adapter for KOOK (开黑啦)",
   "type": "module",
   "main": "./lib/index.js",
@@ -40,16 +40,16 @@
     "@types/react-dom": "^19.2.1",
     "lucide-react": "^1.11.0",
     "typescript": "^6.0.3",
-    "@zhin.js/cli": "1.0.68",
-    "@zhin.js/console": "2.0.15",
-    "zhin.js": "1.0.72"
+    "@zhin.js/cli": "1.0.69",
+    "@zhin.js/console": "2.0.16",
+    "zhin.js": "1.0.73"
   },
   "peerDependencies": {
     "@zhin.js/client": "1.0.18",
-    "@zhin.js/console": "2.0.15",
-    "@zhin.js/http": "1.0.65",
-    "@zhin.js/logger": "0.1.54",
-    "zhin.js": "1.0.72"
+    "@zhin.js/console": "2.0.16",
+    "@zhin.js/http": "1.0.66",
+    "@zhin.js/logger": "0.1.55",
+    "zhin.js": "1.0.73"
   },
   "peerDependenciesMeta": {
     "@zhin.js/client": {

package/skills/kook/SKILL.md

@@ -2,7 +2,11 @@
 name: kook
 platforms:
   - kook
-description: KOOK 服务器管理：群管（踢人、封禁、解封、改昵称、查成员）、角色管理（创建/删除/授予/撤销）、黑名单。仅昵称时请先 list_members 获取 user_id。
+description: >-
+  KOOK 服务器管理能力。当用户在 KOOK 中请求群管（踢人、封禁、解封、改昵称）、
+  角色管理（创建/删除/授予/撤销角色）、黑名单操作或查询成员列表时使用。
+  即使用户没有提到 KOOK，只要上下文是 KOOK 场景且涉及上述操作，就应触发。
+  仅有昵称时必须先 list_members 获取 user_id。
 keywords:
   - kook
   - KOOK
@@ -10,20 +14,19 @@ keywords:
   - 群管理
   - 角色
   - 黑名单
+  - 封禁
   - list_members
 tags:
   - group
   - management
   - im
 tools:
-  # 平台特有工具
   - kook_grant_role
   - kook_revoke_role
   - kook_list_roles
   - kook_create_role
   - kook_delete_role
   - kook_blacklist
-  # 通用群管工具
   - kook_kick_member
   - kook_ban_member
   - kook_unban_member
@@ -31,31 +34,47 @@ tools:
   - kook_list_members
 ---
 
-## 工具概览
+# KOOK 服务器管理技能
 
-### 平台特有
+KOOK 的管理模型类似 Discord，以角色为核心。此技能覆盖成员管理和角色系统。
 
-| 工具 | 说明 | 权限 |
+## 核心原则
+
+### ID 获取链
+
+操作成员需要 KOOK 用户 ID，操作角色需要角色 ID：
+- `kook_list_members` → 获取用户 ID
+- `kook_list_roles` → 获取角色 ID
+
+### 黑名单 ≠ 踢人
+
+`kook_blacklist` 是永久性封禁，被拉黑的用户无法再加入服务器。`kook_kick_member` 只是移除，用户可以通过邀请重新加入。
+
+## 工具详解
+
+### 成员管理
+
+| 工具 | 用途 | 说明 |
 |------|------|------|
-| `kook_grant_role` | 授予角色 | group_admin |
-| `kook_revoke_role` | 撤销角色 | group_admin |
-| `kook_list_roles` | 获取角色列表 | user |
-| `kook_create_role` | 创建角色 | group_admin |
-| `kook_delete_role` | 删除角色 | group_admin |
-| `kook_blacklist` | 黑名单操作 | group_admin |
+| `kook_kick_member` | 踢出 | 可重新加入 |
+| `kook_ban_member` | 封禁 | 阻止重新加入 |
+| `kook_unban_member` | 解除封禁 | — |
+| `kook_set_nickname` | 改昵称 | 服务器内昵称 |
+| `kook_list_members` | 成员列表 | — |
+| `kook_blacklist` | 黑名单操作 | **不可逆，谨慎使用** |
 
-### 通用群管
+### 角色管理
 
-| 工具 | 说明 | 权限 |
+| 工具 | 用途 | 说明 |
 |------|------|------|
-| `kook_kick_member` | 踢出成员 | group_admin |
-| `kook_ban_member` | 封禁成员 | group_admin |
-| `kook_unban_member` | 解除封禁 | group_admin |
-| `kook_set_nickname` | 修改成员昵称 | group_admin |
-| `kook_list_members` | 获取成员列表 | user |
+| `kook_create_role` | 创建角色 | — |
+| `kook_delete_role` | 删除角色 | — |
+| `kook_grant_role` | 授予角色 | 需 user_id + role_id |
+| `kook_revoke_role` | 撤销角色 | 需 user_id + role_id |
+| `kook_list_roles` | 角色列表 | 获取所有角色及 ID |
 
-## 执行规则
+## 易错点
 
-1. 操作成员需要 KOOK 用户 ID，仅有昵称时先调 `kook_list_members`
-2. 角色操作需要角色 ID，先调 `kook_list_roles` 查询
-3. 黑名单操作会永久封禁用户，需谨慎使用
+1. **黑名单是永久封禁**，与普通踢人（kick）不同。用户说「把他踢了」用 kick，说「永久拉黑」才用 blacklist。
+2. **角色操作需要 role_id**，先 `kook_list_roles` 查询。
+3. **创建角色后还需要 grant_role 才能给成员分配**，创建 ≠ 分配。