@honor-claw/yoyo 0.0.1-beta.2 → 0.0.1-beta.21

package/skills/yoyo-control/SKILL.md

@@ -1,34 +1,35 @@
 ---
-name: yoyo-control
+name: YOYO-phone-control
 version: 1.0.0
-description: Whenever a task requires **operating or controlling the phone**, eg. open app, send message, search contact, create schedule, phone calls, screen record, capture screenshot, volume, local search, etc.
+description: 用于控制和操作手机系统功能及本地信息的工具集合，包括打开或关闭应用、发送短信、拨打电话、搜索联系人、创建闹钟、截屏、屏幕录制、调节音量、切换响铃/静音/勿扰模式、管理移动数据或热点、进行本地内容搜索等。
 metadata: { "openclaw": { "emoji": "📱", "always": true } }
 ---
 
-# Control phone with YOYO
+# YOYO Phone Control
 
-Follow the workflow to control phone or pad with YOYO, Don't guess the commands.
+**严格按照以下4步工作流**完成手机设备控制：
 
-## Workflow
+1. 查询节点状态以识别可用设备，并确定目标设备
+2. 根据工具参考文档选择工具，提取命令和参数
+3. 使用正确的节点标识符、命令和参数调用节点方法
+4. 展示结果并确认操作是否成功
 
-Follow this **4-step workflow** when using the skill:
-
-1. Query the device status to identify available device nodes.
-2. Determine the target node, required tool, and execution parameters based on the user's intent.
-3. Call the node tool using the correct parameter format.
-4. Present the result and confirm whether the operation was successful.
-
-### Step 1. Discover Nodes
+## 步骤 1：确定目标设备
 
 **Command**: `openclaw nodes status`
 
-**Purpose**: Retrieve current status of all nodes in the system to identify available devices ready to receive commands.
+**Purpose**: 获取系统中所有节点的当前状态，识别可用于接收命令的设备
 
-**Execution result**:
+**Result Parameters Description**:
 
-| Node       | ID       | IP       | Detail   | Status   | Caps   |
-| ---------- | -------- | -------- | -------- | -------- | ------ |
-| <nodeName> | <nodeId> | <nodeIP> | <detail> | <status> | <caps> |
+| Parameter | Type   | Description                                                                            | Example                   |
+| --------- | ------ | -------------------------------------------------------------------------------------- | ------------------------- |
+| `Node`    | String | 设备名称，显示节点的友好标识名称                                                       | `Honor Magic6 Pro`        |
+| `ID`      | String | 节点唯一标识符，用于命令调用时的 `--node` 参数（推荐使用）                             | `f5f8916028aa5`           |
+| `IP`      | String | 节点网络IP地址，也可用于命令调用时的 `--node` 参数 （强烈使用）                        | `192.168.1.100`           |
+| `Detail`  | String | 设备详细信息，可能包含设备型号、操作系统版本等信息                                     | `Magic6 Pro, Android 14`  |
+| `Status`  | String | 节点连接状态，值包括：`connected`（已连接）、`disconnected`（离线）、`unknown`（未知） | `connected`               |
+| `Caps`    | String | 节点能力列表，逗号分隔的能力标识，表示该设备支持的操作类型                             | `app,call,message,volume` |
 
 #### Capability Matching Logic
 
@@ -44,6 +45,7 @@ Match device capabilities with user intent:
 
 **Automatic Selection** (single best match):
 
+- If there is only one node connected, then it is considered to be the target one.
 - Only one node matches all required capabilities
 
 **User Confirmation Required** (multiple candidates):
@@ -66,75 +68,83 @@ Match device capabilities with user intent:
 - ✅ If multiple nodes match, ask user to select OR control all if appropriate
 - ✅ If no suitable node found, clearly inform user with available options
 
-## Step 2. Plan Tool and Extract Command & Params
+## Step 2. Plan Tool and Extract Command & Paramters
 
-**⚠️ MANDATORY: Consult tool reference documentation before every operation**
+**⚠️ MANDATORY: Consult tool reference before every operation**
 
-Before executing any device control operation, you **MUST** consult the corresponding tool's command and parameter definition file in the `references/` directory. This is a non-negotiable requirement to ensure correct command and parameters.
+Before executing any device control operation, you **MUST** consult the corresponding tool's definition file in the `references/` directory. This is a non-negotiable requirement to ensure correct command and parameters.
 
 ### Available Tool References
 
-| Reference File                     | Capability       | Description                                                                                                                                                          | Required Node Caps     |
-| ---------------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
-| `references/volume.md`             | Volume Control   | Adjust, set, increase, decrease, mute/unmute device volume; query current volume status; fine-grained control by stream type (media, call, ringtone, notification)   | `volume.operate`       |
-| `references/phone-call.md`         | Phone Call       | Initiate and manage phone calls; unified control for call operations                                                                                                 | `phone.call`           |
-| `references/screen-recorder.md`    | Screen Recording | Start/stop screen recording; configure recording parameters; query recording status; app-specific recording control                                                  | `screen.record`        |
-| `references/capture-screenshot.md` | Screenshot       | Capture current screen content as image; support standard and scrolling screenshot modes                                                                             | `capture.shot`         |
-| `references/schedule.md`           | Schedule         | Provides the ability to create schedules                                                                                                                             | `schedule.create`      |
-| `references/search-contact.md`     | Contact          | Provides the ability to search contacts                                                                                                                              | `search.contact `      |
-| `references/open-app.md`           | Open Application | Used to help users open a specified app without any specific app internals.                                                                                          | `app.open`             |
-| `references/send-message.md`       | Send Message     | Provide SMS sending services, users can send SMS content to specified numbers by providing phone numbers or contact information.                                     | `send.message`         |
-| `references/local-search.md`       | Local Search     | Search native data for documents, notes, calendars, galleries, yoyo memories, wallets, and more for direct answers to user questions or generate at-a-glance content | `message.send.message` |
-
-### Parameter Construction Workflow
-
-Execute the following steps **in strict order** for each operation:
+| Required Node Caps   | Reference File                     | Tool Description                                                                                                                                                                                                 |
+| -------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mobile-data`        | `references/mobile-data.md`        | 移动数据与流量管理工具。提供对移动数据及流量管理相关功能的综合管理与控制，支持开关移动数据、切换SIM卡、查询流量使用情况/账单/排行、设置流量限额与提醒、控制应用级流量、流量校准及省流量模式等功能。              |
+| `hotspot`            | `references/hotspot.md`            | 个人热点管理工具。提供对个人热点功能的统一管理与控制，支持个人热点的开启与关闭、参数设置以及当前状态查询，并可结合指定应用执行相关操作。                                                                         |
+| `volume`             | `references/volume-operate.md`     | 设备音量调节与管理工具。提供对设备音量的调节与管理功能，支持音量的设置、调高、调低、开启与关闭，以及当前音量状态的查询；可针对不同应用、不同设备及不同音量类型（如媒体、通话、通知等）进行精细化控制。           |
+| `no-disturb`         | `references/no-disturb.md`         | 免打扰模式管理工具。支持在特定时间段或特定情况下屏蔽来电和通知，减少干扰，提高专注度。提供即时开关、定时设置、联系人例外、应用通知控制等功能。                                                                   |
+| `screen-record`      | `references/screen-record.md`      | 设备屏幕录制管理与控制工具。提供对设备屏幕录制功能的管理与控制能力，支持对屏幕录制功能的开启与关闭、相关录制参数的设置、当前录制状态的查询，并可结合指定应用对其在特定应用场景下的录制行为进行管理。             |
+| `quiet-mode`         | `references/quiet-mode.md`         | 设备静音模式管理与控制工具。提供对设备静音模式的管理与控制能力，支持静音模式的开启与关闭、当前状态的查询、静音持续时间的设置，以及结合指定应用或设备进行声音控制。                                               |
+| `ringing-mode`       | `references/ringing-mode.md`       | 响铃模式管理工具。提供对系统响铃模式的管理与控制能力，支持对响铃模式的开启与关闭、相关行为的设置以及当前状态的查询，并可结合指定应用对其在响铃模式下的表现进行管理。                                             |
+| `vibration-mode`     | `references/vibration-mode.md`     | 系统震动反馈管理与控制工具。提供对系统震动反馈功能的统一管理与控制能力，支持震动模式的设置、状态查询、打开与关闭，并可分别管理静音状态下震动、响铃状态下震动，以及在点击导航栏或设备解锁等交互场景中的震动反馈。 |
+| `capture-screenshot` | `references/capture-screenshot.md` | 截屏功能管理与触发工具。提供对截屏功能的管理与触发能力，支持将当前手机屏幕内容以图片的形式保存，包括普通截屏和滚动截屏等操作。                                                                                   |
+| `app`                | `references/app-open.md`           | 应用打开工具。用于帮助用户关闭指定的 APP 应用，且不涉及任何具体 App 内部操作。                                                                                                                                   |
+| `app`                | `references/app-close.md`          | 应用关闭工具。用于帮助用户打开指定的 APP 应用，且不涉及任何具体 App 内部操作。                                                                                                                                   |
+| `contact`            | `references/contact-search.md`     | 联系人查找服务工具。提供按姓名、昵称、电话号码检索联系人的能力，支持区分自然人名与机构/黄页条目，可处理模糊匹配、多结果列表展示及序号选择场景。                                                                  |
+| `call`               | `references/call-phone.md`         | 智能电话拨打与管理工具。提供全面的电话呼叫功能，支持通过姓名、电话号码或黄页服务发起呼叫；支持指定拨号使用的SIM卡（移动/联通/电信/卡槽）；具备重拨最后号码、回拨已接听来电、回拨未接听来电及通用回拨功能；       |
+| `message`            | `references/message-send.md`       | 提供发送短信的服务。支持通过电话号码或联系人名称发送短信内容，可使用黄页发送短信至公共服务号码，以及发送名片信息给指定联系人。                                                                                   |
+| `local-search`       | `references/local-search.md`       | 查询手机文档、笔记、日程、图库、yoyo记忆、钱包等                                                                                                                                                                 |
+| `alarm`              | `references/alarm-create.md`       | 闹钟创建工具。用于创建闹钟，当用户明确创建/定一个闹钟时，属于创建闹钟。                                                                                                                                          |
+
+### Command and Parameters Construction Workflow
+
+Execute the following steps **in strict order** for each operation to construct parameter:
 
 ```
 ┌─────────────────────────────────────────────────────────────┐
 │  Step 1: INTENT RECOGNITION                                 │
-│  Parse user request → Identify target tool and operation    │
+│  Parse user request → Identify target tool to use           │
 └─────────────────────────────────────────────────────────────┘
                               ↓
 ┌─────────────────────────────────────────────────────────────┐
 │  Step 2: DOCUMENT CONSULTATION [MANDATORY]                  │
-│  Open references/*.md → Read tool definitions               │
+│  Open references/*.md → Read tool reference                 │
 │  ⚠️ PROHIBITED: Skip, guess, assume, or rely on memory      │
 └─────────────────────────────────────────────────────────────┘
                               ↓
 ┌─────────────────────────────────────────────────────────────┐
-│  Step 3: PARAMETER EXTRACTION                               │
-│  Extract: type, enum values, required/optional, defaults    │
-└─────────────────────────────────────────────────────────────┘
-                              ↓
-┌─────────────────────────────────────────────────────────────┐
-│  Step 4: JSON CONSTRUCTION                                  │
-│  Build params object conforming to JSONSchema definiton     │
-└─────────────────────────────────────────────────────────────┘
-                              ↓
-┌─────────────────────────────────────────────────────────────┐
-│  Step 5: VALIDATION                                         │
+│  Step 3: PARAMETER EXTRACTION AND VALIDATION                │
 │  Verify: required fields present, enum case-sensitive match │
 └─────────────────────────────────────────────────────────────┘
 ```
 
-### Error Handling Protocol
+### Parameter Format Requirements
 
-| Scenario                  | Required Action                                                                                                           |
-| ------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
-| **Ambiguous Request**     | User request unclear or missing required fields → Ask clarifying questions before proceeding                              |
-| **Unsupported Operation** | No matching tool definition found → Inform user: "Operation '[operation]' is not supported. Available operations: [list]" |
-| **Capability Mismatch**   | Selected node lacks required capability → Inform user and suggest alternative device or operation                         |
+- Parameters must be valid JSON
+- Enum values must match documentation exactly (case-sensitive)
+- Numeric values must be within defined ranges
+
+### Error Handling Protocolreference
+
+| Scenario                  | Required Action                                                                                                          |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| **Ambiguous Request**     | User request unclear or missing required fields → Ask clarifying questions before proceeding                             |
+| **Unsupported Operation** | No matching tool reference found → Inform user: "Operation '[operation]' is not supported. Available operations: [list]" |
+| **Capability Mismatch**   | Selected node lacks required capability → Inform user and suggest alternative device or operation                        |
 
 ### ⚠️ Prohibited Actions
 
-- ❌ **DO NOT** construct parameters from memory or guesswork
+- ❌ **DO NOT** guess command names from user intent
 - ❌ **DO NOT** skip document consultation before executing commands
 - ❌ **DO NOT** use parameter values not defined in the documentation
+- ❌ **DO NOT** infer parameter structure from similar tools
+- ❌ **DO NOT** assume enum values without checking reference
+
+## Step 3. Invoke Node With Command and Parameters
 
-## Step 3. Invoke Node With Command And Params
+**Command**:
 
-**Command**: `openclaw nodes invoke --node <id|ip> --command <command> --params <json>`
+- window(CMD): `openclaw nodes invoke --node <IP> --command <command> --params "<json>"`
+- Other: `openclaw nodes invoke --node <IP> --command <command> --params '<json>'`
 
 **Purpose**: Send command to target node and initiate operation.
 
@@ -142,72 +152,57 @@ Execute the following steps **in strict order** for each operation:
 
 **Execute these validation steps in order. DO NOT skip any step.**
 
-| Step | Validation             | Action                                                 | On Failure                                                      |
-| ---- | ---------------------- | ------------------------------------------------------ | --------------------------------------------------------------- |
-| 1    | **Node Identifier**    | Extract `ID` or `IP` column from `nodes status` output | ❌ STOP: "Cannot use node name. Use ID or IP from nodes status" |
-| 2    | **Tool Documentation** | Read `references/<tool>.md` file completely            | ❌ STOP: "Tool documentation not found"                         |
-| 4    | **Command Name**       | Extract `command` exactly from tool documentation      | ❌ STOP: "Command mismatch. Check documentation"                |
-| 3    | **Required Params**    | Extract `params` from tool documentation               | ❌ STOP: "Missing required field: [field]"                      |
+| Step | Validation          | Action                                                 | On Failure                                           |
+| ---- | ------------------- | ------------------------------------------------------ | ---------------------------------------------------- |
+| 1    | **Node Identifier** | Extract `IP` or `ID` column from `nodes status` output | ❌ STOP: "Cannot use node. Use ID from nodes status" |
+| 2    | **Tool Reference**  | Read `references/<tool>.md` file completely            | ❌ STOP: "Tool reference not found"                  |
+| 4    | **Command Name**    | Extract `command` exactly from tool documentation      | ❌ STOP: "Command mismatch. Check documentation"     |
+| 3    | **Required Params** | Extract `params` from tool documentation               | ❌ STOP: "Missing required field: [field]"           |
+
+### Platform Detection and Command Format
+
+**⚠️ CRITICAL: Platform detection is mandatory and cannot be skipped.**
 
-#### Node Identifier Rules
+Before executing any command, you **MUST** detect the current platform and use the appropriate command format. Using the wrong format will cause command execution failures.
+
+#### Platform Detection Logic
 
 ```
 ┌─────────────────────────────────────────────────────────────┐
-│  CORRECT: Use ID or IP from nodes status output             │
-│  ✅ openclaw nodes invoke 192.168.1.100 --command ...       │
-│  ✅ openclaw nodes invoke f5f8916028aa5 --command ...       │
+│  DETECT PLATFORM BEFORE COMMAND EXECUTION                   │
 ├─────────────────────────────────────────────────────────────┤
-│  INCORRECT: Use Node name column                            │
-│  ❌ openclaw nodes invoke "Honor Magic6" --command ...      │
-│  ❌ openclaw nodes invoke "My Phone" --command ...          │
+│  1. Check OS type (Windows/Linux/macOS)                     │
+│  2. Verify shell type (CMD/Bash/PowerShell)                 │
+│  3. Apply corresponding quote style and escaping rules      │
+│  4. Execute command with platform-specific format           │
 └─────────────────────────────────────────────────────────────┘
 ```
 
-### Anti-Hallucination Rules
-
-**Before constructing ANY command, you MUST:**
-
-1. ✅ **READ** the tool documentation file completely
-2. ✅ **COPY** command name exactly from documentation
-3. ✅ **VERIFY** each parameter against JSONSchema
-4. ✅ **MATCH** enum values character-by-character
-
-**PROHIBITED actions that cause hallucination:**
-
-- ❌ **DO NOT** guess command names from user intent
-- ❌ **DO NOT** infer parameter structure from similar tools
-- ❌ **DO NOT** assume enum values without checking documentation
-- ❌ **DO NOT** use node names from the "Node" column in status output
-
-### Parameter Format Requirements
-
-| Platform                     | Format                                  | Example                 |
-| ---------------------------- | --------------------------------------- | ----------------------- |
-| **Bash (Linux/macOS)**       | Single quotes wrapping JSON             | `'{"level":50}'`        |
-| **Windows (PowerShell/CMD)** | Double quotes with escaped inner quotes | `"{\"level\":50}"`      |
-| **Complex Objects**          | Create JSON file first                  | `--params @params.json` |
+#### Platform-Specific Command Formats
 
-**Additional Requirements**:
+| Platform    | Shell Type | Quote Style                     | JSON Escaping Required | Example Command                                                                              |
+| ----------- | ---------- | ------------------------------- | ---------------------- | -------------------------------------------------------------------------------------------- |
+| **Windows** | CMD        | Double quotes, escape inner `"` | ✅ YES                 | `openclaw nodes invoke <IP> --command phone.call --params "{\"actionType\":\"打电话\"}"`     |
+| **Windows** | PowerShell | Double quotes, escape inner `$` | ✅ YES                 | `openclaw nodes invoke <IP> --command phone.call --params "{\`"actionType\`":\`"打电话\`"}"` |
+| **Linux**   | Bash       | Single quotes                   | ❌ NO                  | `openclaw nodes invoke <IP> --command phone.call --params '{"actionType":"打电话"}'`         |
+| **macOS**   | Bash/Zsh   | Single quotes                   | ❌ NO                  | `openclaw nodes invoke <IP> --command phone.call --params '{"actionType":"打电话"}'`         |
 
-- Parameters must be valid JSON
-- Enum values must match documentation exactly (case-sensitive)
-- Numeric values must be within defined ranges
+**Universal execution method (all platforms):**
 
-### Examples
+Use the invoke script which automatically handles platform-specific JSON parameter formatting and shell execution.
 
 ```bash
-# ✅ CORRECT: Execute volume control after consulting volume.md
-# Documentation: command = "volume.operate", params = { actionType: "增加" | "减少" | "关闭", level?: number }
-openclaw nodes invoke 192.168.1.100 --command volume.operate --params '{"actionType":"增加","level":50}'
+node {baseDir}/scripts/invoke.js --node <ID> --command <command> --params '<json>'
+```
 
-# ❌ INCORRECT: Using node name instead of ID/IP
-# openclaw nodes invoke "My Phone" --command volume.operate --params '{"actionType":"增加"}'
+**Execution examples:**
 
-# ❌ INCORRECT: Wrong command name
-# openclaw nodes invoke <nodeId> --command volume --params '{"action":"up"}'
+```bash
+# Phone call
+node {baseDir}/scripts/invoke.js --node 192.168.1.100 --command phone.call --params '{"actionType":"打电话","phoneNumber":"10086"}'
 
-# ❌ INCORRECT: Enum case mismatch
-# openclaw nodes invoke <nodeId> --command volume.operate --params '{"actionType":"UP"}'
+# Volume control
+node {baseDir}/scripts/invoke.js --node 192.168.1.100 --command volume.operate --params '{"actionType":"增加","level":50}'
 ```
 
 ### Error Handling
@@ -227,9 +222,9 @@ openclaw nodes invoke 192.168.1.100 --command volume.operate --params '{"actionT
 
 ```
 ┌─────────────────────────────────────────────────────────────┐
-│  RETRY FLOW (Max 3 attempts)                                │
+│  RETRY FLOW (Max 2 attempts)                                │
 ├─────────────────────────────────────────────────────────────┤
-│  Attempt 1 → FAIL → Wait 1s → Attempt 2 → FAIL → Wait 2s   │
+│  Attempt 1 → FAIL → Wait 1s → Attempt 2 → FAIL → Wait 1s   │
 │  → Attempt 3 → FAIL → STOP & REPORT ERROR                   │
 │                                                             │
 │  ⚠️ After 3 failed attempts:                                │
@@ -334,13 +329,3 @@ Would you like to check other nodes or retry later?"
 - ❌ **DO NOT** expose raw error codes to users
 - ❌ **DO NOT** assume user knows technical details
 - ❌ **DO NOT** leave user without next steps on failure
-
-## 快速参考命令
-
-```bash
-# 获取所有节点状态
-openclaw nodes status
-
-# 调用工具
-openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>
-```