docs: improve agent skill references and intent guide clarity

- Enhance product skill docs with clearer examples and descriptions
- Update intent-guide with better routing patterns
- Expand simple.md with comprehensive onboarding examples
- Fix inconsistent command references across skill docs

skills/references/products/aitable.md

@@ -236,13 +236,13 @@ Usage:
 Example:
   dws aitable record query --base-id <BASE_ID> --table-id <TABLE_ID>
   dws aitable record query --base-id <BASE_ID> --table-id <TABLE_ID> --record-ids rec1,rec2
-  dws aitable record query --base-id <BASE_ID> --table-id <TABLE_ID> --query "关键词" --limit 50
+  dws aitable record query --base-id <BASE_ID> --table-id <TABLE_ID> --keyword "关键词" --limit 50
 Flags:
       --base-id string      Base ID (必填)
       --cursor string       分页游标，首次不传
       --field-ids string    返回字段 ID 列表，逗号分隔，单次最多 100 个
       --filters string      结构化过滤条件 JSON
-      --query string      全文关键词搜索
+      --keyword string     全文关键词搜索
       --limit int           单次最大记录数，默认 100，最大 100
       --record-ids string   指定记录 ID 列表，逗号分隔，单次最多 100 个
       --sort string         排序条件 JSON 数组

skills/references/products/chat.md

@@ -6,7 +6,7 @@
 |-------|------|
 | `search` | 搜索群聊 |
 | `group create` | 创建群 |
-| `group members` | 查看群成员列表 |
+| `group members list` | 查看群成员列表 |
 | `group members add` | 添加群成员 |
 | `group members remove` | 移除群成员（⚠️ 危险操作） |
 | `group members add-bot` | 添加机器人到群 |
@@ -48,13 +48,13 @@ Flags:
 
 ---
 
-## group members — 查看群成员列表
+## group members list — 查看群成员列表
 
 ```
 Usage:
-  dws chat group members [flags]
+  dws chat group members list [flags]
 Example:
-  dws chat group members --id <openConversationId> --format json
+  dws chat group members list --id <openConversationId> --format json
 Flags:
       --id string       群会话 ID (必填)
       --cursor string   分页游标
@@ -226,7 +226,7 @@ Flags:
 
 - 用户说"搜索一个群" → `search`
 - 用户说"帮我建个群" → `group create`
-- 用户说"看看群里有谁" → `group members`
+- 用户说"看看群里有谁" → `group members list`
 - 用户说"把张三拉进群" → 先 `contact user search` 获取 userId，再 `group members add`
 - 用户说"把张三移出群" → 先 `contact user search` 获取 userId，再 `group members remove`（⚠️ 需确认）
 - 用户说"改一下群名" → `group rename`
@@ -245,7 +245,7 @@ Flags:
 # ── 工作流: 建群并添加机器人 ──
 
 # 1. 搜索同事 userId
-dws contact user search --query "张三" --format json
+dws contact user search --keyword "张三" --format json
 
 # 2. 创建群
 dws chat group create --name "项目群" --users <userId1>,<userId2> --format json

skills/references/products/contact.md

@@ -17,9 +17,9 @@ Example:
 Usage:
   dws contact user search [flags]
 Example:
-  dws contact user search --query "张三"
+  dws contact user search --keyword "张三"
 Flags:
-      --query string   搜索关键词 (必填)
+      --keyword string   搜索关键词 (必填)
 ```
 
 #### 按手机号搜索用户
@@ -49,9 +49,9 @@ Flags:
 Usage:
   dws contact dept search [flags]
 Example:
-  dws contact dept search --query "技术部"
+  dws contact dept search --keyword "技术部"
 Flags:
-      --query string   搜索关键词 (必填)
+      --keyword string   搜索关键词 (必填)
 ```
 
 #### 查看部门成员
@@ -79,10 +79,10 @@ Flags:
 dws contact user get-self --format json
 
 # 2. 按名字搜索同事 — 提取 userId
-dws contact user search --query "张三" --format json
+dws contact user search --keyword "张三" --format json
 
 # 3. 查看部门结构 — 提取 deptId
-dws contact dept search --query "技术部" --format json
+dws contact dept search --keyword "技术部" --format json
 
 # 4. 查看部门成员
 dws contact dept list-members --ids <deptId> --format json
@@ -94,7 +94,7 @@ dws contact dept list-members --ids <deptId> --format json
 |------|------|------|
 | `user get-self/search` | `userId` | 其他产品中的 --users/--executor 参数 |
 | `user get-self/search` | `orgAuthEmail` | mail message send 的 --to/--cc (跨产品) |
-| `dept search/list-children` | `deptId` | dept list-children/list-members 的 --id/--ids |
+| `dept search` | `deptId` | dept list-members 的 --ids |
 
 ## 注意事项
 
@@ -105,4 +105,4 @@ dws contact dept list-members --ids <deptId> --format json
 
 | 脚本 | 场景 | 用法 |
 |------|------|------|
-| [contact_dept_members.py](../../scripts/contact_dept_members.py) | 按部门名称搜索并列出所有成员 | `python contact_dept_members.py --query "技术部"` |
+| [contact_dept_members.py](../../scripts/contact_dept_members.py) | 按部门名称搜索并列出所有成员 | `python contact_dept_members.py --keyword "技术部"` |

skills/references/products/report.md

@@ -35,7 +35,7 @@ Flags:
       --template-id string   日志模版 ID (必填)，从 template list 返回中取
       --contents string      日志内容 JSON 数组 (必填)，每项须含 key/sort/content/contentType/type
       --dd-from string       创建来源标识 (默认 dws)
-      --to-chat              是否发送到日志接收人单聊 (默认 false，传本 flag 则为 true)
+      --to-chat string       是否发送到日志接收人单聊 (传 "true" 发送)
       --to-user-ids string   接收人 userId，逗号分隔 (可选)
 ```
 

skills/references/products/simple.md

@@ -18,32 +18,90 @@ Flags:
       --size string      每页数量 (默认 10)
 ```
 
----
-
-## approval — 审批
-
-### 查询审批表单
+### 搜索错误码
 ```
 Usage:
-  dws approval list-forms [flags]
+  dws devdoc article search-error [flags]
 Example:
-  dws approval list-forms --format json
+  dws devdoc article search-error --keyword "403" --format json
+Flags:
+      --keyword string   错误码或关键词 (必填)
+```
+
+---
+
+## oa — 审批
+
+### 查询可见审批流程
+```
+Usage:
+  dws oa approval list-forms [flags]
+Example:
+  dws oa approval list-forms --format json
 ```
 
 ### 查询审批实例详情
 ```
 Usage:
-  dws approval detail --instance-id <ID> [flags]
+  dws oa approval detail --instance-id <ID> [flags]
 Example:
-  dws approval detail --instance-id <ID> --format json
+  dws oa approval detail --instance-id <ID> --format json
 ```
 
-### 查询审批任务
+### 查询审批记录
 ```
 Usage:
-  dws approval tasks --instance-id <ID> [flags]
+  dws oa approval records --instance-id <ID> [flags]
 Example:
-  dws approval tasks --instance-id <ID> --format json
+  dws oa approval records --instance-id <ID> --format json
+```
+
+### 查询待我审批的任务
+```
+Usage:
+  dws oa approval tasks [flags]
+Example:
+  dws oa approval tasks --format json
+```
+
+### 查询待我处理的审批
+```
+Usage:
+  dws oa approval pending [flags]
+Example:
+  dws oa approval pending --format json
+```
+
+### 查询我发起的审批
+```
+Usage:
+  dws oa approval initiated [flags]
+Example:
+  dws oa approval initiated --format json
+```
+
+### 同意审批
+```
+Usage:
+  dws oa approval approve --instance-id <ID> --task-id <TASK_ID> [flags]
+Example:
+  dws oa approval approve --instance-id <ID> --task-id <TASK_ID> --format json
+```
+
+### 拒绝审批
+```
+Usage:
+  dws oa approval reject --instance-id <ID> --task-id <TASK_ID> [flags]
+Example:
+  dws oa approval reject --instance-id <ID> --task-id <TASK_ID> --remark "不符合要求" --format json
+```
+
+### 撤销审批
+```
+Usage:
+  dws oa approval revoke --instance-id <ID> [flags]
+Example:
+  dws oa approval revoke --instance-id <ID> --format json
 ```
 
 ---
@@ -51,12 +109,20 @@ Example:
 ## 意图判断
 
 - 用户说"开发文档/API 文档/接口文档" → `devdoc article search`
-- 用户说"审批/请假/报销/出差" → `approval`
+- 用户说"API 报错/错误码" → `devdoc article search-error`
+- 用户说"审批/请假/报销/出差" → `oa approval`
+- 用户说"同意审批/批准" → `oa approval approve`
+- 用户说"拒绝审批/驳回" → `oa approval reject`
+- 用户说"撤销审批/撤回" → `oa approval revoke`
+- 用户说"待我审批/我要审批的" → `oa approval pending` 或 `oa approval tasks`
+- 用户说"我发起的审批" → `oa approval initiated`
 
 ## 上下文传递表
 
 | 操作 | 从返回中提取 | 用于 |
 |------|-------------|------|
 | `devdoc article search` | 文档链接 | 直接展示给用户 |
-| `approval list-forms` | processCode | `approval detail` / `approval tasks` 等 |
-| `approval tasks` | taskId | `approval approve` / `approval reject` |
+| `oa approval list-forms` | processCode | detail / records 等 |
+| `oa approval tasks` | taskId, instanceId | approve / reject |
+| `oa approval pending` | instanceId | detail / approve / reject |
+| `oa approval initiated` | instanceId | detail / revoke |

skills/references/products/todo.md

@@ -8,12 +8,11 @@ Usage:
   dws todo task create [flags]
 Example:
   dws todo task create --title "修复线上Bug" --executors <USER_ID_1>,<USER_ID_2> --priority 40
-  dws todo task create --title "每日站会" --executors <USER_ID> --due "2026-03-20T10:00:00+08:00" --recurrence "DTSTART:20260320T020000Z\nRRULE:FREQ=DAILY;INTERVAL=1"
+  dws todo task create --title "提交报告" --executors <USER_ID> --due "2026-03-20T10:00:00+08:00"
 Flags:
       --due string         截止时间 ISO-8601 (如 2026-03-10T18:00:00+08:00)
       --executors string   执行者 userId 列表 (必填)
       --priority string    优先级: 10低/20普通/30较高/40紧急
-      --recurrence string  循环待办 (需先设置 --due); 仅支持按天循环，格式见下方说明
       --title string       待办标题 (必填)
 ```
 
@@ -81,7 +80,6 @@ Flags:
 ## 意图判断
 
 用户说"加个待办/记一下/TODO" → `task create`
-用户说"每天重复/循环待办/按天重复" → `task create`（需 `--due` + `--recurrence`）
 用户说"看看待办/我有啥要做" → `task list`
 用户说"改个待办/修改待办标题/改优先级" → `task update`
 用户说"做完了/完成待办/标记完成" → `task done`
@@ -97,11 +95,6 @@ Flags:
 dws todo task create --title "修复线上Bug" --executors userId1,userId2 \
   --priority 40 --due "2026-03-10T18:00:00+08:00" --format json
 
-# 1b. 创建按天循环的待办（必须先有 --due；recurrence 与 MCP create_personal_todo 一致）
-dws todo task create --title "每日站会" --executors userId1 \
-  --due "2026-03-20T10:00:00+08:00" \
-  --recurrence "DTSTART:20260320T020000Z\nRRULE:FREQ=DAILY;INTERVAL=1" --format json
-
 # 2. 查看未完成待办
 dws todo task list --page 1 --size 20 --status false --format json
 
@@ -129,7 +122,6 @@ dws todo task delete --task-id <taskId> --yes --format json
 
 - 优先级值: 10=低, 20=普通, 30=较高, 40=紧急
 - `--due` 截止时间使用 ISO-8601 格式（如 2026-03-10T18:00:00+08:00）
-- `--recurrence`：仅在与 `--due` 同时设置时有效；当前仅支持按天循环。字符串内需含换行，示例：`DTSTART:20260320T020000Z\nRRULE:FREQ=DAILY;INTERVAL=1`（DTSTART 表示首次截止时间，需与业务约定一致）
 - `task list` 的 `--status` 对应 MCP `get_user_todos_in_current_org` 的 `todoStatus` 参数
 - todo 是个人待办管理产品
 - `task update` 可同时修改标题/优先级/截止时间/完成状态