该技能的作用

cloudphone 通过 mcporter 调用 cpc-mcp-server 工具，引导智能体在云手机环境中执行 Android 自动化任务。

该技能适用于以下场景：

• 基于 AutoJS 的云手机自动化
• 应用回归测试 / 冒烟测试执行
• 远程批量操作工作流
• 在云 Android 设备上执行脚本化交互

何时使用该技能

当用户提出如下请求时，请使用该技能：

• “在云手机上运行一个脚本”
• “使用 AutoJS 自动化该应用的操作流程”
• “远程执行 Android UI 操作并返回截图/日志”
• “使用 cpc-mcp-server 实现云设备自动化”

不应使用该技能的场景

请勿将该技能用于以下情况：

• 本地 ADB / 模拟器自动化（非云设备）
• iOS 自动化（例如 XCUITest）
• 不涉及真实设备执行的静态脚本/代码审查
• 无具体可执行任务目标的纯咨询类请求

必要前提条件（执行前必须满足）

在任何调用之前，请确保已正确配置身份认证。

cpc-mcp-server 要求提供：

• Authorization: Bearer

该技能通过以下方式标准化 API 密钥：

• CLOUDPHONE_API_KEY（必需）

具体要求

1. 设置环境变量 CLOUDPHONE_API_KEY。
2. 确保在执行前已启用 MCP 服务端的请求头注入功能：
   • Authorization: Bearer $CLOUDPHONE_API_KEY
3. 切勿在代码仓库文件、SKILL.md 或配置 JSON 中硬编码或提交真实密钥。

该技能仅定义命名规范与前置条件。
密钥注入的具体实现由运行时或环境配置负责。

调用模型（通过 mcporter）

该技能不直接调用 MCP 工具，而是通过 mcporter CLI 向 cpc-mcp-server 发起工具调用。

常用命令模式如下：

• 列出已配置的 MCP 服务器：
  • mcporter list
• 查看服务器 Schema：
  • mcporter list cpc-mcp-server --schema
• 使用 JSON 参数调用工具（推荐）：
  • mcporter call cpc-mcp-server. --args ''

对于长指令、多语言文本或含特殊字符的内容，建议优先使用 --args 方式传入 JSON。

最小输入检查清单（创建任务前需确认）

请首先收集以下字段（仅在缺失时主动追问）：

1. 目标应用（名称或包名）
2. 预期操作（具体要做什么）
3. 成功标准（何种状态视为完成）
4. 期望输出类型（截图 / 日志 / 文本结果等）

工具 1：创建任务（createAutoJsAgentTask）

目标

创建并分发一个 AutoJS Agent 任务，并获取 taskId（以及可能的 sessionId）。

推荐调用方式

mcporter call cpc-mcp-server.createAutoJsAgentTask --args '{
  "instruction": "在云手机上打开 ，使用测试账号登录，导航至订单页面，截取一张屏幕截图，并返回订单总数。",
  "lang": "zh"
}'