OneKeyHQ

OneKey cross-platform patterns, platform files, platformEnv, and supported OS/SDK requirements.

OneKey development commands plus branch, commit, validation, and PR conventions.

Analyze accumulated bug fix cases and propose updates to the self-testing checklist. Use periodically (weekly/monthly) to evolve quality checks based on real issues.

Drive OneKey desktop or mobile apps to verify real visual and interactive behavior using CDP/Playwright or agent-device. Use for UI 验证 or screenshot confirmation.

Review OneKey PRs and diffs for security, correctness, concurrency, React/RN pitfalls, and repository-specific regressions. Use for code review or 审查 PR.

Code quality standards — lint (oxlint), format (oxfmt), type check (tsc), pre-commit hooks, and comment conventions. All comments must be in English.

Navigate and implement OneKey App Earn, Borrow, Staking, and DeFi Portfolio flows. Use for protocol data, portfolio actions, transactions, pending/history, refresh, and Earn routes.

Navigate OneKey App Swap, Bridge, Limit, and Stock/Market flows. Use for token selection, quotes, review/build/send, providers, cold start, and history/status; use the Perps skill for Hyperliquid.

Recorder - CDP 录制器。捕获用户在 OneKey 上的操作，生成操作清单。 Triggers on: /onekey-recorder, "录制", "record", "开始录制".

Use when 用户发送图片（包含带序号的单词，如测试钱包助记词/恢复短语卡片截图、硬件设备助记词屏幕、单词列表截图）并要求提取时。Triggers on: "提取测试单词", "提取单词", "extract test words".

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

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

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

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

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

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

Analyze, add, map, serialize, test, or review Hardware JS SDK errors within either the independent hd-core or hwk error system, including public codes, transport/vendor mapping, cross-runtime failures, retry and cleanup semantics, and user recovery.

Analyze or change Hardware JS SDK package ownership, Core/transport boundaries, public API compatibility, Device lifecycle, or legacy hd-* versus hwk-* architecture.

Implement or review hardware-wallet chain support, address derivation, signing methods, derivation paths, transaction serialization, message signing, or device capability checks.

Create or review an implementation plan, technical plan, task breakdown, acceptance criteria, or validation matrix for a Hardware JS SDK change.

Create a Hardware JS SDK Pull Request from current changes, including scoped staging, validation, commit, push, and an evidence-based PR description. Invoke only when the user explicitly asks to create or submit a PR.

Choose Hardware JS SDK setup, development, build, test, protobuf, example, validation, branch, or commit commands. Use when asked how to run, build, test, validate, or develop this repository.

Update or review firmware-pro2 submodules, Protocol V2 protobuf sources, generated schemas/types, firmware messages, or SDK/firmware compatibility. Use explicitly because it can move submodule pointers or regenerate artifacts.

Prepare an explicitly authorized Hardware JS SDK version, package build, compatibility check, npm publication, release notes, or release PR. Never invoke implicitly.

Use when the user asks about token price, BTC/SOL market questions, trending tokens, search token, kline chart, candlestick data, trading volume, top holders, liquidity, token info, 代币价格, 热门代币, K线, BTC 行情, SOL 行情, or 搜索代币. Do NOT use for swap execution — use…

Use when the user asks is this token safe, wants a honeypot check, security scan, simulate transaction, risk assessment, hardware wallet safety, App Transfer/App Transport Bot Wallet secret safety, seed/private-key exposure requests, 代币安全, 蜜罐检测, 安全审计, 硬件钱包安全,…

Use when the user asks to swap tokens, trade ETH for USDC, buy tokens, sell tokens, exchange crypto, get a swap quote, check swap status, perform a cross-chain swap or bridge, swap SOL/SPL, swap BTC/TBTC, sign a BTC PSBT, 换币, 买币, 卖币, 兑换, 交易, or 跨链. Do NOT use…

Use when the user asks to log in with OneKey App Transfer/App Transport Bot Wallet or hardware wallet, check balance/assets, receive or derive BTC/Solana addresses, send/transfer BTC/SOL/tokens, view history, check wallet status, 查余额, 登录钱包, 硬件钱包, 转账, 发送, 收款,…

Structured PR code review checklist for OneKey monorepo. Use when reviewing PRs to identify build issues, script problems, CI workflow gaps, and documentation inconsistencies. Focuses on actionable feedback with priority levels and specific fix suggestions.…

Git workflow and conventions for OneKey development. Use when creating branches, committing code, or creating PRs. Triggers on git, branch, commit, PR, pull request, merge, workflow.