用途：本技能本身只承载知识而非代码，用于引导 AI 助手把用户路由到正确的 OKX AI Builder 接入路径，并帮助其把参考示例改造成自己的可用集成。可运行示例位于公开仓库 https://github.com/okx/builder-integration-demo（引用 github-main）。
主要能力与流程：
- 申请 AI Builder：先在 OKX 登录并进入 AI Builder Program 页面（https://www.okx.com/agent-tradekit/builder），点击 Apply Now 选择 AI Builder，填写申请人与项目信息并确认邮箱，接受服务条款后提交；提交后立即获得 Builder Code，可在审核期间完成集成与测试。官方指南称审核约 1–2 个工作日，未激活的 Code 也可用于技术集成与测试，佣金在批准并激活后按小时结算（T+1 小时）。
- 判定用户类型：openapi-user（自有服务器直接签名调用 OpenAPI）、cli-user（通过 okx 命令行）、mcp-user（通过 OKX MCP 工具）、oauth-user（第三方服务代终端用户交易，需 OAuth + Fast API）。权威路由表为仓库 docs/USER_TYPES.md。
- 前置准备：openapi-user 需创建 API Key（测试可用模拟盘 Key），下单前读取 GET /api/v5/account/config 并按 acctLv 决定 tdMode 与是否可用 SWAP；cli-user 需安装 OKX Trade CLI（当前为 npm i -g @okx_ai/okx-trade-cli，以官方安装指南为准）并配置 API Key 或 CLI OAuth；mcp-user 在宿主应用中连接授权，凭据由宿主管理；oauth-user 需在 AI Builder 工作台 Settings 配置 OAuth 与 Fast API（应用名、Logo、redirect_uri、IP 白名单），确认邮箱后 OKX 会发送 CLIENT_ID/CLIENT_SECRET。
- 获取示例：无 shell 环境用 GitHub 链接查看文件；有 shell 时按固定 ref 克隆，如 git clone --depth 1 --branch github-main https://github.com/okx/builder-integration-demo okx-ai-builder-demo。
- 使用示例：按 README 的 Copy vs Adapt 分桶处理文件，逐字复制签名客户端，适配业务逻辑，不复制测试、.env.example 与示例文档；cli/mcp 的产物是 SKILL.md，需替换占位符并改写相对链接。
集成规则：所有产生订单的调用需携带 AI Builder Code，参数名因界面而异（--ai-builder-code、--aiBuilderCode、aiBuilderCode、AI_BUILDER_CODE 环境变量），不得重命名 OKX 的 tag 字段；Code 非机密，大小写敏感，1–16 位字母数字；API Key 仅开读取与交易权限，禁用提现；密钥不得出现在前端、提示词、日志或提交文件中；默认使用模拟交易，验证归因后再考虑实盘。
限制：不支持第三方服务器 + CLI、第三方服务器 + MCP；示例为验证过的简单实例，非生产实现；若仓库结构与技能描述不一致，以仓库为准并提示技能可能过时。具体申请细节与错误处理请以官方指南和示例仓库文档为准。