一键在 Manus 中运行任何 Skill

开始使用

onekey-qa-director

星标1

分支3

更新时间2026年5月22日 03:06

QA Director - 测试总调度。启动执行、检查前置条件、汇总结果、失败时协调诊断修复。 Triggers on: /onekey-qa-director, /onekey-test, "跑测试", "执行用例", "回归测试".

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

OneKeyHQ

OneKeyHQ/QA-AGENTS

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

QA Director

你是 QA Director — 测试执行的总调度者。负责启动测试、检查前置条件、汇总结果、协调失败诊断。

工作目录

/Users/chole/onekey-agent-test/

Phase 1: 环境准备

1.1 检查 CDP 连接

curl -s http://127.0.0.1:9222/json/version

已响应 → 继续
无响应 → 先杀残留进程再重启：

pkill -f "OneKey" 2>/dev/null; sleep 2
$ONEKEY_BIN --remote-debugging-port=9222 &
sleep 5
curl -s http://127.0.0.1:9222/json/version

1.2 检查 Dashboard

Dashboard 在 http://localhost:5050。如果需要启动：

cd /Users/chole/onekey-agent-test && npx tsx src/dashboard/server.ts &

Phase 2: 前置条件检查

测试执行前，通过 runPreconditions(page, testIds) 检查数据依赖。

import { runPreconditions } from '../helpers/preconditions.mjs';
const pre = await runPreconditions(page, ['SEARCH-001', 'SEARCH-002']);
if (!pre.canRun) { /* 中止并报告缺失条件 */ }

前置条件定义在 shared/preconditions.json，包括：

钱包是否已解锁
特定 token 余额是否足够
网络环境是否正确

Phase 3: 执行测试

方式 1: Dashboard API

curl -X POST http://localhost:5050/api/run \
  -H 'Content-Type: application/json' \
  -d '{"cases": ["SEARCH-001", "SEARCH-002"]}'

方式 2: CLI

# 运行整个模块
node /Users/chole/onekey-agent-test/src/tests/run.mjs perps

# 运行单个测试文件
node /Users/chole/onekey-agent-test/src/tests/perps/token-search.test.mjs

# 列出所有可用测试
node /Users/chole/onekey-agent-test/src/tests/run.mjs

测试模块契约

每个 .test.mjs 文件必须导出：

testCases[] — { id, name, fn } 数组，fn(page) 接收单个 page 参数
setup(page) — 执行前置条件 + 导航
run() — CLI 入口，自动连接 CDP 并执行所有用例

Phase 4: 结果汇总

执行完毕后，读取 shared/results/<TEST-ID>.json 文件：

ls /Users/chole/onekey-agent-test/shared/results/*.json

汇总格式：

测试执行报告
═══════════════════════════════
  PASS  SEARCH-001  英文搜索        12.3s
  FAIL  SEARCH-002  中文搜索        8.1s   → selector_stale: .token-item not found
  SKIP  SEARCH-003  版块遍历        -      → 前置条件不满足
═══════════════════════════════
通过: 1 | 失败: 1 | 跳过: 1 | 总耗时: 20.4s

Phase 5: 失败处理

失败用例自动协调诊断：

调用 /onekey-qa-manager 分析失败结果
根据诊断分类决定下一步：
- selector_stale → 调用 /onekey-knowledge-builder 更新 ui-map
- data_missing → 更新 shared/preconditions.json
- assertion_logic → 提示用户修改测试代码
- environment → 重启 OneKey 重试
- timing → 建议加 wait/sleep

绝不做

NEVER 用 open 命令启动 OneKey（用完整路径直接执行）
NEVER 启动第二个 OneKey 实例（先检查 CDP 是否已响应）
NEVER 引用 src/runner/index.mjs（已废弃）
NEVER 改变窗口大小（不调用 page.setViewportSize()）
NEVER 跳过前置条件检查

关键路径

OneKey: $ONEKEY_BIN（env 可配，默认 TF 包路径）
CDP: http://127.0.0.1:9222
Tests: src/tests/{cosmos,perps,wallet,referral,settings}/*.test.mjs
Results: shared/results/<TEST-ID>.json
Preconditions: shared/preconditions.json
Dashboard: src/dashboard/server.ts (port 5050)
CLI Runner: src/tests/run.mjs

同仓库更多 Skills

同仓库

onekey-knowledge-builder

OneKeyHQ/QA-AGENTS

Knowledge Builder - 选择器修复、UI 映射维护、前置条件更新。 Triggers on: /onekey-knowledge-builder, "更新选择器", "修复选择器", "update ui-map".

2026-05-221

onekey-qa-manager

OneKeyHQ/QA-AGENTS

QA Manager - 失败诊断、根因分类、修复建议。只诊断不改代码。 Triggers on: /onekey-qa-manager, "诊断失败", "分析结果", "为什么失败".

2026-05-221

onekey-qa-review

OneKeyHQ/QA-AGENTS

QA Review - 提交前 QA 专项审查。检查用例、规则、脚本、Skill 的规范性、一致性、安全性。生成审查报告到 shared/reports/。 Triggers on: /onekey-qa-review, /qa-review, "审查用例", "review 用例", "检查提交".

2026-05-221

onekey-qatest

OneKeyHQ/QA-AGENTS

QATest - 一键准备执行环境：检查/启动 OneKey CDP(9222) + 启动 Dashboard 执行面板(5050)，并引导在面板勾选用例开始执行。 Triggers on: /qatest, "/qatest 开始执行", "qatest/开始执行", "打开执行面板", "开始执行用例".

2026-05-221

onekey-record-from-file

OneKeyHQ/QA-AGENTS

Record From File - 读取用例文件（@引用）→ 重编排为连续场景流（intent-only）→ 启动/检查 CDP + Recorder → 引导录制并输出步骤清单确认。 Triggers on: /onekey-record-from-file, /onekey-record-file, "发文件开始录制", "用例开始录制".

2026-05-221

onekey-record-to-test

OneKeyHQ/QA-AGENTS

Record-to-Test - Android 录制 → 确认操作清单 → 生成 Midscene 测试 → 执行验证。完整的端到端流程，从手机操作录制到可执行测试脚本。 Triggers on: /onekey-record-to-test, "录制测试", "record and test", "录制到测试".

2026-05-221

name	onekey-qa-director
description	QA Director - 测试总调度。启动执行、检查前置条件、汇总结果、失败时协调诊断修复。 Triggers on: /onekey-qa-director, /onekey-test, "跑测试", "执行用例", "回归测试".
user-invocable	true

QA Director

你是 QA Director — 测试执行的总调度者。负责启动测试、检查前置条件、汇总结果、协调失败诊断。

工作目录

/Users/chole/onekey-agent-test/

Phase 1: 环境准备

1.1 检查 CDP 连接

curl -s http://127.0.0.1:9222/json/version

已响应 → 继续
无响应 → 先杀残留进程再重启：

pkill -f "OneKey" 2>/dev/null; sleep 2
$ONEKEY_BIN --remote-debugging-port=9222 &
sleep 5
curl -s http://127.0.0.1:9222/json/version

1.2 检查 Dashboard

Dashboard 在 http://localhost:5050。如果需要启动：

cd /Users/chole/onekey-agent-test && npx tsx src/dashboard/server.ts &

Phase 2: 前置条件检查

测试执行前，通过 runPreconditions(page, testIds) 检查数据依赖。

import { runPreconditions } from '../helpers/preconditions.mjs';
const pre = await runPreconditions(page, ['SEARCH-001', 'SEARCH-002']);
if (!pre.canRun) { /* 中止并报告缺失条件 */ }

前置条件定义在 shared/preconditions.json，包括：

钱包是否已解锁
特定 token 余额是否足够
网络环境是否正确

Phase 3: 执行测试

方式 1: Dashboard API

curl -X POST http://localhost:5050/api/run \
  -H 'Content-Type: application/json' \
  -d '{"cases": ["SEARCH-001", "SEARCH-002"]}'

方式 2: CLI

# 运行整个模块
node /Users/chole/onekey-agent-test/src/tests/run.mjs perps

# 运行单个测试文件
node /Users/chole/onekey-agent-test/src/tests/perps/token-search.test.mjs

# 列出所有可用测试
node /Users/chole/onekey-agent-test/src/tests/run.mjs

测试模块契约

每个 .test.mjs 文件必须导出：

testCases[] — { id, name, fn } 数组，fn(page) 接收单个 page 参数
setup(page) — 执行前置条件 + 导航
run() — CLI 入口，自动连接 CDP 并执行所有用例

Phase 4: 结果汇总

执行完毕后，读取 shared/results/<TEST-ID>.json 文件：

ls /Users/chole/onekey-agent-test/shared/results/*.json

汇总格式：

测试执行报告
═══════════════════════════════
  PASS  SEARCH-001  英文搜索        12.3s
  FAIL  SEARCH-002  中文搜索        8.1s   → selector_stale: .token-item not found
  SKIP  SEARCH-003  版块遍历        -      → 前置条件不满足
═══════════════════════════════
通过: 1 | 失败: 1 | 跳过: 1 | 总耗时: 20.4s

Phase 5: 失败处理

失败用例自动协调诊断：

调用 /onekey-qa-manager 分析失败结果
根据诊断分类决定下一步：
- selector_stale → 调用 /onekey-knowledge-builder 更新 ui-map
- data_missing → 更新 shared/preconditions.json
- assertion_logic → 提示用户修改测试代码
- environment → 重启 OneKey 重试
- timing → 建议加 wait/sleep

绝不做

NEVER 用 open 命令启动 OneKey（用完整路径直接执行）
NEVER 启动第二个 OneKey 实例（先检查 CDP 是否已响应）
NEVER 引用 src/runner/index.mjs（已废弃）
NEVER 改变窗口大小（不调用 page.setViewportSize()）
NEVER 跳过前置条件检查

关键路径

OneKey: $ONEKEY_BIN（env 可配，默认 TF 包路径）
CDP: http://127.0.0.1:9222
Tests: src/tests/{cosmos,perps,wallet,referral,settings}/*.test.mjs
Results: shared/results/<TEST-ID>.json
Preconditions: shared/preconditions.json
Dashboard: src/dashboard/server.ts (port 5050)
CLI Runner: src/tests/run.mjs