> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 技能

> 与模型无关的指令集，教会AI助手如何使用Helius在Solana上进行开发。技能提供路由逻辑、正确的SDK模式、深度参考文件，以及为Claude、OpenAI、Codex、Cursor等预制的系统提示。

技能是与模型无关的指令集，教会AI助手如何将请求路由到正确的[MCP工具](/zh/agents/mcp/tools)和参考文件。它们不仅仅是原始工具访问——还包括路由逻辑、正确的SDK模式和防止常见错误（如硬编码费用、错误的端点或缺失的Sender提示）的规则。

技能适用于**任何AI平台**——Claude Code、Codex、OpenAI API、Claude API、Cursor、ChatGPT等。每个技能都附带预制的系统提示变体，以便您可以将其应用到所使用的任何工具中。

## 可用技能

<CardGroup cols={2}>
  <Card title="Build" icon="hammer" href="/zh/agents/skills/build">
    核心 Solana 开发 — DAS, Sender, WebSockets, LaserStream, Webhooks, Wallet API 等
  </Card>

  <Card title="Phantom" icon="wallet" href="/zh/agents/skills/phantom">
    前端 dApp 开发 — Phantom Connect SDK (React, React Native, 浏览器), token gating, 支付
  </Card>

  <Card title="Jupiter" icon="rocket" href="/zh/agents/skills/jupiter">
    DeFi 应用 — token 交换, 借贷, 限价单, DCA, token/价格数据
  </Card>

  <Card title="DFlow" icon="chart-line" href="/zh/agents/skills/dflow">
    交易应用 — 即期交换, 预测市场, 实时流媒体, Proof KYC
  </Card>

  <Card title="OKX" icon="chart-mixed" href="/zh/agents/skills/okx">
    交易和智能分析 — OKX DEX 集成, smart money 信号, meme token 分析
  </Card>

  <Card title="SVM" icon="microchip" href="/zh/agents/skills/svm">
    Solana 协议内部 — SVM 执行, 共识, 账户模型, 验证者经济
  </Card>
</CardGroup>

## 技能如何工作

技能遵循三层提示架构：

| 层              | 内容              | 位置                                               |
| -------------- | --------------- | ------------------------------------------------ |
| **A: Harness** | 代理/运行时特定行为和工具规则 | 内置（Claude Code），`AGENTS.md`（Codex），提示变体中的前导（API） |
| **B: Skills**  | 经典、可重用、与模型无关的过程 | `SKILL.md`文件 + `references/`目录                   |
| **C: Task**    | 用户请求 + 动态上下文    | 在运行时由每个平台提供                                      |

技能内容（层 B）在各个平台上是相同的——只有保护层（层 A）有所不同。

每个技能包括：

* **路由逻辑** — 将您的请求映射到正确的 MCP 工具和参考文件
* **参考文件** — 在 AI 编写代码前读取的每个 Helius 产品的详细文档
* **规则** — 防止常见错误（例如，硬编码的优先费用、错误的 RPC 端点、缺少错误处理）

## 跨平台使用技能

每个技能在其 `prompts/` 目录中附带三个预构建的提示变体：

| 文件                    | 用例                                      | 格式                                        |
| --------------------- | --------------------------------------- | ----------------------------------------- |
| `openai.developer.md` | OpenAI Responses / Chat Completions API | 层 A 前文 + 带有 `=== BEGIN SKILL ===` 界限的技能内容 |
| `claude.system.md`    | Claude API 系统提示                         | 层 A 前文 + 带有界限的技能内容                        |
| `full.md`             | 光标规则、ChatGPT 自定义指令、其他工具                 | 所有参考文件内联，无外部依赖                            |

可在以下位置找到：

* **仓库**：`.agents/skills/<skill>/prompts/`
* **npm 包**：`helius-mcp/system-prompts/<skill>/`

<Tabs>
  <Tab title="Vercel Skills CLI">
    使用 [Vercel Skills CLI](https://skills.sh/) 将技能直接安装到您的AI编码代理中。适用于Claude Code、Cursor、Copilot、Codex等。

    ```bash theme={"system"}
    # Install a single skill
    npx skills add helius-labs/core-ai --skill build

    # Browse all available Helius skills
    npx skills add helius-labs/core-ai --list
    ```

    | 技能                                                                        | 安装命令                                                 |
    | ------------------------------------------------------------------------- | ---------------------------------------------------- |
    | **build** — 核心 Solana 开发 (Sender, DAS, WebSockets, LaserStream, webhooks) | `npx skills add helius-labs/core-ai --skill build`   |
    | **phantom** — 前端 dApps (Phantom Connect, React, token gating)             | `npx skills add helius-labs/core-ai --skill phantom` |
    | **jupiter** — DeFi 应用 (swaps, lending, limit orders, DCA)                 | `npx skills add helius-labs/core-ai --skill jupiter` |
    | **dflow** — 交易应用 (swaps, prediction markets, streaming, KYC)              | `npx skills add helius-labs/core-ai --skill dflow`   |
    | **okx** — 交易和智能分析 (OKX DEX, smart money, meme scanner)                    | `npx skills add helius-labs/core-ai --skill okx`     |
    | **svm** — 协议内部 (SVM engine, consensus, account model)                     | `npx skills add helius-labs/core-ai --skill svm`     |
  </Tab>

  <Tab title="Claude Code Plugin">
    [Helius 插件](/zh/agents/claude-code-plugin)将所有技能和 MCP 服务器捆绑在一起进行安装。从 Anthropic 精心策划的注册表：

    ```bash theme={"system"}
    claude plugin install helius @claude-plugins-official
    ```

    或者从 Claude Code 中的 Helius 市场：

    ```
    /plugin marketplace add helius-labs/core-ai
    /plugin install helius@helius-labs
    ```

    技能通过 `/helius:build`, `/helius:phantom`, `/helius:jupiter`, `/helius:dflow`, `/helius:okx` 或 `/helius:svm` 调用。
  </Tab>

  <Tab title="Claude Code Standalone">
    每个技能可以使用其 `install.sh` 脚本独立安装:

    ```bash theme={"system"}
    git clone https://github.com/helius-labs/core-ai.git
    cd core-ai/helius-skills
    ./helius/install.sh            # Install to ~/.claude/skills/helius/
    ./helius/install.sh --project  # Or install to current project
    ```

    独立技能自动作为代理技能调用——无需斜线命令。
  </Tab>

  <Tab title="Codex CLI">
    Codex 自动从项目根目录中的 `.agents/skills/` 发现技能：

    ```bash theme={"system"}
    # Copy the .agents/ directory into your project
    cp -r /path/to/core-ai/.agents/ your-project/
    ```

    当您的任务匹配时，技能会隐式触发，或者使用 `$helius`，`$helius-phantom`，`$helius-jupiter`，`$helius-dflow`，`$helius-okx` 或 `$svm` 显式触发。
  </Tab>

  <Tab title="OpenAI API">
    使用 `openai.developer.md` 作为 `developer` 消息：

    ```python theme={"system"}
    from openai import OpenAI

    client = OpenAI()

    with open(".agents/skills/helius/prompts/openai.developer.md") as f:
        skill_prompt = f.read()

    response = client.responses.create(
        model="o3",
        instructions=skill_prompt,
        input="Build a swap interface that submits via Helius Sender"
    )
    ```

    也可以使用 Chat Completions 和 `{"role": "developer", "content": skill_prompt}`。
  </Tab>

  <Tab title="Claude API">
    使用 `claude.system.md` 作为系统提示：

    ```python theme={"system"}
    import anthropic

    client = anthropic.Anthropic()

    with open(".agents/skills/helius/prompts/claude.system.md") as f:
        skill_prompt = f.read()

    message = client.messages.create(
        model="claude-sonnet-4-6-20250514",
        max_tokens=4096,
        system=skill_prompt,
        messages=[
            {"role": "user", "content": "Build a swap interface that submits via Helius Sender"}
        ]
    )
    ```
  </Tab>

  <Tab title="Cursor / ChatGPT">
    使用 `full.md` —— 它内嵌所有引用文件，因此没有外部依赖。

    **Cursor:** 复制到 `.cursor/rules/helius.md`：

    ```bash theme={"system"}
    cp .agents/skills/helius/prompts/full.md .cursor/rules/helius.md
    ```

    **ChatGPT 自定义指令：** 使用核心 `SKILL.md` 内容（`full.md` 可能超过 ChatGPT 的 8,000 字符限制以用于较大技能）。
  </Tab>
</Tabs>

## 前提条件

所有技能需要 [Helius MCP 服务器](/zh/agents/mcp) 运行（或在您的代理框架中配置的等效工具）。DFlow 技能还需要 [DFlow MCP 服务器](https://pond.dflow.net/build/mcp)。Phantom 技能需要 [Phantom Portal](https://phantom.com/portal) 帐户来嵌入钱包。Jupiter 技能需要 [Jupiter API 密钥](https://developers.jup.ag/portal)。OKX 技能需要 [OKX 技能库](https://github.com/okx/onchainos-skills) 和 `onchainos` CLI。

| 技能                                   | 需要                                     | 是否需要 API 密钥             |
| ------------------------------------ | -------------------------------------- | ----------------------- |
| [Build](/zh/agents/skills/build)     | Helius MCP                             | 是 (Helius)              |
| [Phantom](/zh/agents/skills/phantom) | Helius MCP                             | 是 (Helius)              |
| [Jupiter](/zh/agents/skills/jupiter) | Helius MCP                             | 是 (Helius + Jupiter)    |
| [DFlow](/zh/agents/skills/dflow)     | Helius MCP + DFlow MCP                 | 是 (Helius + DFlow 用于生产) |
| [OKX](/zh/agents/skills/okx)         | Helius MCP + OKX 技能库 + `onchainos` CLI | 是 (Helius; OKX 可选用于开发)  |
| [SVM](/zh/agents/skills/svm)         | Helius MCP                             | 否                       |
