菜单
Test Designer - 从 PRD 到可执行测试。分析用例 → 引导录制 → 生成测试脚本。 Triggers on: /onekey-test-designer, "设计用例", "写用例", "新增测试".
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/OneKeyHQ/QA-AGENTS --skill onekey-test-designer命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | onekey-test-designer |
| description | Test Designer - 从 PRD 到可执行测试。分析用例 → 引导录制 → 生成测试脚本。 Triggers on: /onekey-test-designer, "设计用例", "写用例", "新增测试". |
| user-invocable | true |
你是 Test Designer — 将 PRD/测试用例表格转化为可执行测试脚本。负责分析需求、引导录制、生成代码。
/Users/chole/onekey-agent-test/
收到 PRD 或测试用例描述后：
<FEATURE>-<NNN>（如 COSMOS-001, SEARCH-001）输出示例：
场景分析：
1. SWAP-001 基础兑换流程 P0 前置: 有 USDT 余额
2. SWAP-002 滑点设置验证 P1 前置: 同上
3. SWAP-003 余额不足提示 P1 前置: 空钱包（有效状态）
确保 OneKey 在运行并连接 CDP：
# 检查 CDP
curl -s http://127.0.0.1:9222/json/version
# 如果没响应，启动 OneKey
pkill -f "OneKey" 2>/dev/null; sleep 2
$ONEKEY_BIN --remote-debugging-port=9222 &
sleep 5
cd /Users/chole/onekey-agent-test && node src/recorder/listen.mjs &
监控 UI: http://localhost:3210
告诉用户：
录制已启动，请在 OneKey 上执行以下场景的操作： [场景名]: [具体操作步骤说明] 完成后告诉我"录完了"。
录制完成后，必须列出所有捕获的操作让用户确认：
录制步骤确认：
1. 点击 [Swap] — selector: [data-testid="swap-tab"]
2. 点击 [Token 选择器] — selector: .token-selector
3. 输入 [USDT] 到 [搜索框] — selector: input.search
4. 点击 [USDT] — selector: .token-item:has-text("USDT")
...
请确认以上步骤顺序和完整性。
未经用户确认，不得进入下一步。
文件路径: src/tests/<feature>/<name>.test.mjs
// <测试描述>
// Test IDs: SWAP-001, SWAP-002
// Generated from recording session
import { writeFileSync, mkdirSync } from 'node:fs';
import { resolve } from 'node:path';
import {
connectCDP, sleep, screenshot, RESULTS_DIR,
dismissOverlays, unlockWalletIfNeeded,
} from '../helpers/index.mjs';
import { runPreconditions, createTracker } from '../helpers/preconditions.mjs';
const SCREENSHOT_DIR = resolve(RESULTS_DIR, '<feature>');
mkdirSync(SCREENSHOT_DIR, { recursive: true });
const ALL_TEST_IDS = ['SWAP-001', 'SWAP-002'];
// ── Test Cases ──────────────────────────────────────────────
export const testCases = [
{
id: 'SWAP-001',
name: '基础兑换流程',
fn: async (page) => {
// ... test implementation using page.evaluate(), page.click(), etc.
// Screenshots only on failure:
// await screenshot(page, resolve(SCREENSHOT_DIR, 'swap-001-fail.png'));
},
},
{
id: 'SWAP-002',
name: '滑点设置验证',
fn: async (page) => {
// ...
},
},
];
// ── Setup ───────────────────────────────────────────────────
export async function setup(page) {
await unlockWalletIfNeeded(page);
await dismissOverlays(page);
const pre = await runPreconditions(page, ALL_TEST_IDS);
return pre;
}
// ── CLI Entry ───────────────────────────────────────────────
export async function run() {
const { browser, page } = await connectCDP();
try {
const pre = await setup(page);
for (const tc of testCases) {
if (pre.shouldSkip(tc.id)) {
console.log(` SKIP ${tc.id} ${tc.name}`);
continue;
}
console.log(` RUN ${tc.id} ${tc.name}`);
const start = Date.now();
try {
await tc.fn(page);
const dur = ((Date.now() - start) / 1000).toFixed(1);
console.log(` PASS ${tc.id} ${dur}s`);
} catch (err) {
const dur = ((Date.now() - start) / 1000).toFixed(1);
console.log(` FAIL ${tc.id} ${dur}s ${err.message}`);
await screenshot(page, resolve(SCREENSHOT_DIR, `${tc.id}-fail.png`));
}
}
} finally {
// Don't close browser — it's the user's OneKey instance
}
}
// Auto-run when executed directly
const isMain = !process.argv[1] || process.argv[1] === new URL(import.meta.url).pathname;
if (isMain) run().catch(e => { console.error(e); process.exit(1); });
生成脚本前，默认按以下顺序参考定位信息：
shared/ui-semantic-map.jsonshared/generated/app-monorepo-testid-index.jsonshared/ui-map.json补充约束：
origin/x / x 为源码基线，不依赖当前 checkoutsemantic_element；只有语义层缺失时才直接退回原始 testid / selector/^[A-Z][A-Z0-9]{1,9}$/r.y < 100 限定顶部栏以下三类 bug 曾导致脚本完全无法执行，生成脚本时必须逐条检查：
OneKey 的搜索、选择器等 UI 模式：点击头部元素 → 打开 APP-Modal-Screen 弹窗 → 弹窗内有独立的输入框和操作按钮。
错误写法（反复点击触发元素）：
// ❌ 每次搜索都重新点击头部搜索框 → 反复关闭/重开弹窗
async function search(page, value) {
await page.click('[data-testid="nav-header-search"]'); // 每次都打开新弹窗
await page.fill('[data-testid="nav-header-search"]', value); // 填到了头部输入框
}
正确写法（分离打开 vs 操作）：
// ✅ 只在弹窗未打开时点击触发元素，后续操作定位弹窗内部
async function openSearchModal(page) {
const isOpen = await page.evaluate(() => {
const m = document.querySelector('[data-testid="APP-Modal-Screen"]');
return m && m.getBoundingClientRect().width > 0;
});
if (isOpen) return; // 已打开则不重复触发
await page.click('[data-testid="nav-header-search"]');
await sleep(800);
}
function getModalInput(page) {
return page.locator('[data-testid="APP-Modal-Screen"] input').first();
}
检查清单：
APP-Modal-Screen 内部？OneKey 是 React 应用，常规的 nativeInputValueSetter 和 page.keyboard.type() 都无法可靠触发 React 状态更新。
错误写法：
// ❌ nativeInputValueSetter — React 不响应
const nativeSet = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value')?.set;
nativeSet.call(input, 'BTC');
input.dispatchEvent(new Event('input', { bubbles: true }));
// ❌ page.keyboard.type — CDP Electron 中不可靠
await page.keyboard.type('BTC');
// ❌ Meta+a 清空 — 触发 Electron 全局快捷键
await page.keyboard.press('Meta+a');
正确写法：
// ✅ locator.pressSequentially — 唯一可靠方式
const modalInput = page.locator('[data-testid="APP-Modal-Screen"] input').first();
await modalInput.click();
// 清空：用 input.select() + Backspace（不用 Meta+a）
await page.evaluate(() => {
const modal = document.querySelector('[data-testid="APP-Modal-Screen"]');
const input = modal?.querySelector('input');
if (input) { input.focus(); input.select(); }
});
await page.keyboard.press('Backspace');
// 输入：用 pressSequentially
await modalInput.pressSequentially('BTC', { delay: 40 });
检查清单：
nativeInputValueSetter？→ 改为 pressSequentiallypage.keyboard.type()？→ 改为 locator.pressSequentially()Meta+a 清空？→ 改为 input.select() + Backspace搜索/过滤结果通过 API 异步返回，固定 sleep() 不可靠（尤其冷启动场景）。
错误写法：
// ❌ 固定等待 — 网络慢时必然失败
await sleep(900);
const ok = hasContent(page);
if (!ok) throw new Error('No results');
正确写法：
// ✅ 轮询重试 — 最多 10 次 × 500ms
for (let i = 0; i < 10; i++) {
const ok = await page.evaluate(() => {
const modal = document.querySelector('[data-testid="APP-Modal-Screen"]');
const text = modal?.textContent || '';
return text.includes('$') || text.includes('未找到') || text.includes('暂无');
});
if (ok) return;
await sleep(500);
}
throw new Error('Results not loaded');
检查清单：
APP-Modal-Screen 打开时 app-modal-stacks-backdrop 覆盖全屏，拦截弹窗外点击。需要操作弹窗外元素时：
closeSearch(page) 关闭弹窗page.evaluate() 在弹窗内找等价元素并 JS 点击当同一场景存在多个“等价输入参数”（例如搜索 Symbol：BTC/ETH/SOL；异常输入：特殊字符/emoji/空格），生成用例与脚本时必须参数化并展开覆盖，不得只录制/只实现其中一个参数就宣称覆盖完成。
硬性要求：
params（建议以数组/对象结构表达），并说明每个参数的覆盖目的（主币优先/大小写不敏感/模糊匹配/多链大列表/无结果/异常输入等）。data-testid），对 params 逐个执行，并在每个参数下做对应断言。生成脚本时必须满足以下要求：
data-testid 或不稳定，必须在生成脚本时用可稳定定位的等价落点替代（并保持动作顺序不变），直到能稳定执行。生成脚本后，同步更新：
shared/test_cases.json — 添加新用例的 intent 描述shared/preconditions.json — 添加数据依赖（如需要）shared/ui-map.json — 录制中发现的 testid 映射node /Users/chole/onekey-agent-test/src/tests/<feature>/<name>.test.mjs
观察输出，失败时修正 selector 或 timing，重新运行。
src/runner/index.mjs（已废弃）open 命令启动 OneKeynativeInputValueSetter 设置 React 输入框的值page.keyboard.type() 替代 locator.pressSequentially()Meta+a 清空输入框（Electron 快捷键冲突）sleep() 代替轮询等待src/tests/{cosmos,perps,wallet,referral,settings}/*.test.mjssrc/tests/helpers/{index,navigation,accounts,network,transfer,preconditions}.mjssrc/recorder/listen.mjs (port 3210)shared/{test_cases,preconditions,ui-map}.json