1. 项目概述Solana Skills 是什么以及它如何重塑开发体验如果你正在 Solana 生态里搞开发无论是想快速集成 Jupiter 的 Swap还是想调用 Helius 的 RPC或者只是想写个安全的智能合约那你大概率经历过这样的场景打开一堆文档在不同项目的 GitHub、Discord 和官方文档之间反复横跳复制粘贴代码片段然后祈祷它们能正常工作。这个过程不仅耗时而且容易出错。今天要聊的Solana Skills就是为了解决这个痛点而生的。简单来说它是一个为 AI 智能体比如 Claude Code设计的技能库但它本质上是一个高度结构化、可被机器理解和执行的“开发知识图谱”能让你和你的 AI 助手在 Solana 开发中直接调用经过验证的最佳实践。想象一下你不再需要记住 Jupiter API 的具体端点格式或者 Helius 的 Webhook 设置方法。你只需要告诉你的 AI 编码伙伴“帮我用 Jupiter Ultra 获取一个 SOL 到 USDC 的报价并执行交换”它就能自动调用jupiter这个 Skill生成正确的、可运行的代码。这背后Solana Skills扮演了“标准操作手册”的角色。它覆盖了 DeFi、基础设施、交易、预言机、数据分析、NFT、安全等几乎全栈的 Solana 开发领域将每个主流协议或服务的核心功能封装成了一个个独立的、可插拔的“技能”。对于开发者而言这意味着开发效率的指数级提升和认知负担的大幅降低。这个项目适合所有层次的 Solana 开发者。对于新手它提供了即学即用的代码范例和标准流程避免了从零开始的摸索对于有经验的开发者它是一个强大的效率工具和代码质量保障确保你调用的 API 和模式是最佳实践。更重要的是它代表了开发范式的一种转变从“人查阅文档并编写代码”转向“人描述意图AI 基于标准化技能库生成代码”。接下来我会详细拆解它的设计思路、核心技能、以及如何将它深度集成到你的工作流中。2. 核心设计思路与架构解析2.1 为什么是“Skills”而不是“SDK”初看Solana Skills你可能会觉得它像另一个聚合 SDK。但它的设计哲学有本质不同。传统的 SDK 是一个面向开发者的代码库你需要导入、初始化、学习其 API 调用方式。而Skills是面向“智能体”的它的首要目标是让 AI如 Claude Code能够理解并执行某个特定领域的任务。这种设计带来了几个关键优势意图驱动而非 API 驱动你不需要知道具体的函数名和参数顺序你只需要用自然语言描述你想做什么意图。AI 负责将意图映射到正确的 Skill 和具体的操作上。上下文感知与自动发现在 Claude Code 或 Cursor 中Skills 是“隐身”的。当你聊天时提到“Jupiter 限价单”AI 会自动加载并使用jupiterskill无需你显式声明。这极大地简化了交互流程。标准化与一致性每个 Skill 都遵循统一的规范基于 Agent Skills Specification这确保了不同协议、不同功能的实现方式有一致的接口和文档结构减少了 AI 的混淆和错误。项目的架构基于一个简单的目录结构每个 Skill 都是一个独立的文件夹如skills/jupiter/里面包含了让 AI 理解如何操作该协议所必需的所有信息自然语言描述、代码示例、可用的工具Tools定义、以及相关的上下文信息。这种模块化设计使得社区贡献新 Skill 变得非常容易也便于维护和更新。2.2 技能生态的广度与深度分析Solana Skills的技能列表几乎是一份 Solana 生态的“黄页”。我们可以将其分为几个核心层次基础层Infrastructure Client这是开发的基石。例如helius和quicknode提供了 RPC 连接、数据查询和交易发送等核心能力solana-kit提供了现代、轻量的底层 SDKlight-protocol涉及 ZK 压缩等前沿基础设施。没有这些上层应用无从谈起。资产与流动性层DeFi Trading这是生态中最活跃的部分。Skills 覆盖了从 AMM (orca,raydium,meteora)、聚合器 (jupiter)、到借贷 (kamino,marginfi,lulo)、杠杆交易 (ranger-finance)、以及新兴的 Pump.fun 等完整矩阵。这意味着你可以用同一套“语言”指挥 AI 操作几乎所有主流 DeFi 协议。数据与信息层Data Analytics Oracles智能合约需要可靠的外部数据。pyth和switchboard提供了链上预言机集成方案birdeye和metengine则提供了丰富的链上分析数据用于构建策略或仪表盘。应用与安全层NFT, Security, DevOpsmetaplex覆盖了 NFT 创建的完整流程vulnhunter和code-recon专注于智能合约安全审计的自动化辅助surfpool则提供了带主网分叉的开发环境方便测试。这种分层覆盖确保了无论你的项目处于哪个阶段、需要哪种功能都能找到对应的 Skill 来加速开发。它不是一个简单的工具列表而是一个相互关联、覆盖开发全生命周期的能力集合。3. 核心技能深度解析与实操要点3.1 DeFi 核心技能以 Jupiter 和 Kamino 为例Jupiter Skill聚合交易的瑞士军刀jupiterskill 可能是使用频率最高的技能之一。它封装了 Jupiter Aggregator 的完整功能包括报价Quote获取最优交易路径和预估价格。交换Swap执行代币交换交易。限价单Limit Order下达限价订单。定期定额投资DCA设置定期购买计划。永续合约Perpetuals访问 Jupiter 的永续合约市场。实操心得当使用 AI 通过 Jupiter Skill 进行交换时最关键的是提供清晰的代币地址和金额。例如不要说“换点 SOL 成 USDC”而应该说“用 Jupiter 将 0.1 SOL地址 So11111111111111111111111111111111111111112交换为 USDC地址 EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v”。AI 会根据这个意图自动调用 quote API 获取路线然后构建并返回一个完整的、已序列化的交易对象你只需要签名并发送即可。Kamino Skill借贷与流动性的精细化管理kaminoskill 专注于 Kamino 协议的借贷与流动性提供。对于开发者而言其价值在于处理了复杂的计算和状态管理头寸健康度计算AI 可以帮你计算某个借贷头寸的当前健康因子预测在价格变动下何时会被清算。流动性池操作指导你如何向 Kamino 的集中流动性池子添加/移除流动性并自动计算应存入的资产比例。杠杆循环Looping策略这是高级 DeFi 策略。你可以描述“我想用 10 SOL 作为抵押品在 Kamino 上以 2 倍杠杆做多 SOL”AI 会利用 Skill 中的知识生成分步操作的交易序列先存入抵押品借出稳定币用借来的稳定币购买更多 SOL再存入作为抵押品... 这个过程如果手动操作极易出错而 Skill 提供了标准化的安全流程。3.2 基础设施关键技能Helius 与开发环境Helius Skill超越基础 RPCheliusskill 不仅仅是封装了 RPC 调用。它深度集成了 Helius 的增强型 APIDAS APIDigital Asset Standard这是获取 NFT、代币持有信息等资产数据的标准方式。Skill 让 AI 知道如何正确查询“获取某个钱包的所有 Compressed NFT”。Webhook 管理监听链上事件是许多应用的核心。你可以让 AI “创建一个监听所有 Pump.fun 代币创建事件的 Webhook”它会基于 Skill 生成设置 Webhook 所需的代码包括过滤器配置和回调端点处理逻辑。优先费用Priority Fee估算在 Solana 网络拥堵时Skill 可以指导 AI 调用 Helius 的接口获取实时推荐的费用并据此构建交易确保交易能及时上链。Surfpool Skill主网分叉开发环境surfpool这个技能对于智能合约开发者至关重要。它允许你在本地或测试网环境中“分叉”主网状态。这意味着真实数据测试你的合约可以针对主网当前真实的代币价格、流动性池状态进行测试结果更具参考性。安全沙盒你可以在不影响真实资产的情况下测试复杂的交互流程例如模拟一次针对真实 DeFi 协议的闪电贷攻击以检验自己合约的安全性。实操要点使用此技能时你需要明确告诉 AI 要分叉哪个区块高度或使用最新区块以及需要哪些账户的状态。AI 会生成启动 Surfpool 环境并加载指定状态的配置代码。4. 集成与工作流实战以 Claude Code 和 Cursor 为例4.1 在 Claude Code 中打造专属 Solana 开发助手Claude Code 是目前与Solana Skills集成体验最好的平台之一。以下是详细的设置和实战流程添加技能市场在 Claude Code 聊天框中首先需要添加 SendAI 的技能市场源。这是最关键的一步它相当于为你的 Claude 安装了一个“应用商店”。/plugin marketplace add sendaifun/skills执行后Claude 会确认市场源添加成功。按需安装技能接下来你可以根据当前项目需求安装特定技能。例如如果你正在开发一个 DeFi 聚合器可以安装/plugin install jupiter /plugin install helius /plugin install pyth安装过程是瞬间完成的。之后这些技能的知识和工具就对 Claude 可用了。实战对话示例场景一创建代币并添加流动性你“我想在 Solana 上创建一个新的 MEME 代币总供应量 10 亿并初始在 Raydium 创建一个流动性池投入 5 SOL 和 5% 的代币供应量。”Claude (借助metaplex和raydiumskills)“好的我将分步进行。首先使用 Metaplex 的metaplex-foundation/mpl-token-metadata程序来创建你的代币。我们需要先创建 Mint 账户然后创建 Metadata。这是代码...”“代币创建成功后地址是YOUR_TOKEN_MINT。接下来使用 Raydium 的 CLMM集中流动性做市商来创建池子。我们需要计算初始价格。假设 5 SOL 对应 5% 的代币即5000万枚那么初始价格为 1 SOL 1000万代币。这是初始化池子和添加流动性的交易构建代码...”“请注意创建池子需要支付 SOL 作为费用并且要确保你的钱包里有足够的 SOL 来支付交易费和提供流动性。”场景二监控钱包并执行策略你“帮我写一个脚本监控这个钱包ADDRESS的大额 SOL 转出交易50 SOL当发生时通过 Jupiter 将其持有的所有 USDC 快速换成 SOL。”Claude (借助helius和jupiterskills)“我们可以使用 Helius 的 Webhook 来监听该地址的交易。首先我为你生成创建 Webhook 的代码过滤器设置为该地址的TRANSFER指令并过滤金额。”“这是 Webhook 的端点处理函数示例。当检测到符合条件的转出时它会查询该钱包的 USDC 余额使用getTokenAccounts然后调用 Jupiter 的 Quote 和 Swap API 生成一个‘卖出所有 USDC 换取 SOL’的交易。”“最后这里有一个使用solana/web3.js自动签名并发送交易的逻辑。你需要安全地保管好钱包的私钥。”验证技能是否生效项目文档提供了一个很好的测试方法。直接问 Claude“How do I get a quote and swap with Jupiter Ultra?” 如果它回复中提到了 Jupiter API 的端点如https://api.jup.ag/swap/v1/quote并给出了具体的代码示例而不是泛泛而谈那就说明jupiterskill 已成功加载并工作。4.2 在 Cursor 中实现上下文感知的智能编码Cursor 是另一款流行的 AI 集成 IDE。Solana Skills在 Cursor 中的集成方式更“隐形”但同样强大。配置远程规则打开 Cursor 设置 (Cmd/Ctrl Shift J)。导航到Rules Commands-Project Rules。点击Add Rule选择Remote Rule (GitHub)。在输入框中填入https://github.com/sendaifun/skills.git保存后Cursor 会拉取这个规则库。工作原理Cursor 的规则系统会分析你项目中的代码上下文和你的聊天指令。当它检测到你在讨论 Solana 开发并提及了某个技能相关的关键词如“Helius RPC”、“Pyth 价格”它会自动从远程规则库即 Skills 项目中加载对应的上下文信息注入到 AI 模型中。这意味着你无需显式安装AI 就已经具备了相关技能的知识。实战体验当你在一个 Solana 项目文件中直接问 Cursor“这个函数里怎么用 Helius 的getPriorityFeeEstimate来设置优先费用” Cursor 会直接引用heliusskill 中的示例给出准确的 API 调用方法和参数说明因为它已经通过规则库“知道”了这个技能的存在。4.3 通用集成方案适用于任何 AI 智能体对于其他支持 Agent Skills Specification 的 AI 智能体或自定义开发Solana Skills提供了最通用的集成方式npx skills add sendaifun/skills这条命令会通过npx调用skillsCLI 工具将sendaifun/skills这个技能包添加到你的智能体环境中。这要求你的智能体框架本身支持该规范。这种方式赋予了最大的灵活性允许你将 Solana Skills 嵌入到自研的 AI 工作流或自动化脚本中。5. 高级应用场景与避坑指南5.1 构建复杂多步交易Solana 上的高级 DeFi 操作往往涉及多个协议的连续调用例如“循环贷”Looping或“套利”Arbitrage。Solana Skills在此类场景下价值巨大因为它能确保每一步都符合协议的最佳实践。场景在 Kamino 上进行杠杆做多 SOL。意图解析AI 首先需要理解“杠杆做多”意味着存入抵押品 - 借出稳定币 - 购买更多标的资产 - 可能再次存入作为抵押品循环。技能调度这个过程会涉及kamino借贷、jupiter交换等多个技能。交易构建AI 会按顺序生成多个指令Instructions指令1Kaminodeposit存入 SOL 作为抵押品。指令2Kaminoborrow借出 USDC。指令3Jupiterswap将借出的 USDC 全部换成 SOL。指令4Kaminodeposit将新换来的 SOL 再次作为抵押品存入实现杠杆放大。原子打包最关键的一步AI 会知道需要将这些指令打包到同一个交易中以确保原子性要么全部成功要么全部失败避免中间状态暴露风险。它会使用solana-kit或相关 SDK 的Transaction构建方法。避坑指南在构建此类复杂交易时计算预留的租金Rent和交易费Fee至关重要。AI 可能会根据技能知识提醒你在模拟交易simulateTransaction时不仅要看指令是否成功还要关注计算单元CU消耗和账户创建所需的 SOL 预留。务必在钱包中预留比预估多 20-30% 的 SOL 作为缓冲以防因网络状态变化导致交易因余额不足而失败。5.2 安全技能的使用VulnHunter 与 Code Recon对于智能合约开发者vulnhunter和code-recon是两个强大的辅助安全技能。VulnHunter它更像一个自动化的代码扫描器。你可以将你的程序代码或部分代码片段提供给 AI并询问“用 VulnHunter 的技能检查一下这段withdraw函数有没有常见的安全漏洞。” AI 会调用该技能背后的模式库检查是否存在重入、权限校验缺失、算术溢出、未验证的跨程序调用CPI等风险并给出具体的代码行和修改建议。Code Recon这个技能更偏向于架构和上下文理解。它帮助 AI 深入理解一个 Solana 程序的整体架构、账户关系和数据流。例如你可以问“基于 Code Recon分析一下这个借贷程序画出核心账户之间的关联图。” AI 会尝试解析程序的指令、账户约束AccountMeta和状态结构为你梳理出安全审计所需的关键上下文这对于理解复杂程序尤其有帮助。重要提示这些 AI 安全技能是强大的辅助工具但绝不能替代专业的人工审计。它们擅长发现已知模式的漏洞但对于逻辑漏洞、复杂的经济模型攻击等仍需经验丰富的审计员。务必将其作为代码审查流程的补充而非最终的安全保障。5.3 性能优化Pinocchio Development Skillpinocchio-development技能专注于一个非常专业的领域零拷贝Zero-Copy反序列化和高性能 Solana 程序开发。Solana 区块链对计算单元CU有严格限制优化程序性能可以节省用户费用并提高吞吐量。这个技能会指导 AI 如何使用borsh或bytemuck等库配合solana_program的account_info直接对账户数据进行“原地”读写避免将整个账户数据反序列化到内存中带来的巨大 CU 消耗。AI 可以帮你将传统的反序列化代码重构为零拷贝版本通常能减少 80-95% 的 CU 使用量。这对于开发高频交易、游戏或任何对成本敏感的程序来说是一个必学的进阶技巧。6. 常见问题与排查技巧实录在实际使用Solana Skills与 AI 协作的过程中你可能会遇到一些典型问题。以下是我根据经验整理的排查清单问题现象可能原因排查步骤与解决方案AI 完全忽略技能回答很笼统1. 技能市场未添加或安装失败。2. 在 Cursor 中远程规则未正确加载。3. AI 的上下文窗口未包含技能信息。1.验证安装在 Claude Code 中再次运行/plugin list查看已安装技能。在 Cursor 中检查项目规则列表是否有sendaifun/skills。2.明确引用在提问时直接提及技能名。例如“使用jupiter skill来帮我获取一个报价”。3.重启会话有时 AI 的上下文需要刷新。尝试开启一个新的聊天会话。AI 生成的代码运行时出现 RPC 错误1. RPC 端点不可用或速率受限。2. 技能中的 API 端点已过时。3. 交易模拟失败余额不足、计算单元超限等。1.检查网络确认你使用的 RPC 提供商如 Helius、QuickNodeURL 正确且账户有足够的配额。2.检查技能版本Skills 项目会更新。确保你安装的是最新版本。可以尝试重新安装技能 (/plugin reinstall jupiter)。3.模拟交易在发送交易前务必使用connection.simulateTransaction(tx)进行模拟。仔细阅读模拟返回的日志logs和错误信息它能精准定位问题所在如“账户不存在”、“签名缺失”、“计算单元耗尽”。AI 对复杂多步操作的理解有偏差自然语言描述存在歧义或 AI 对业务逻辑的分解有误。1.分步拆解不要一次性提出过于复杂的请求。将其分解为多个清晰的步骤逐步与 AI 确认。例如先完成“创建代币”再“创建流动性池”。2.提供关键参数明确给出所有必要的地址、金额、滑点等参数减少 AI 猜测的空间。3.人工复核逻辑对于涉及资金安全的操作如借贷、杠杆务必亲自复核 AI 生成的交易指令序列确保逻辑符合你的预期。在 Cursor 中技能不生效1. 远程规则链接错误或网络问题。2. Cursor 的 AI 模型未正确应用规则。3. 项目上下文不匹配。1.检查规则链接确认 GitHub 仓库地址拼写无误。2.重载规则在 Cursor 设置中尝试禁用再启用该远程规则。3.检查文件类型确保你正在编辑的文件是.js,.ts,.rs(Rust) 等与 Solana 开发相关的文件Cursor 的上下文感知依赖于文件类型。使用npx skills add失败1. Node.js 版本过低或未安装。2. 网络问题导致包下载失败。3. 目标 AI 智能体框架不支持该规范。1.检查环境运行node -v确保 Node.js 版本在 16 以上。2.清理缓存尝试运行npx clear-npx-cache后重试。3.查阅框架文档确认你使用的智能体框架如 LangChain, LlamaIndex 的特定版本是否官方支持agentskills规范。最后一个最重要的体会是将 AI 和 Skills 视为一个强大的“副驾驶”而不是“自动驾驶”。它们能极大提升从想法到代码的实现速度并减少低级错误。但对于最终的代码逻辑、尤其是涉及资产安全和核心业务的部分你必须保持理解和控制。每次运行 AI 生成的、尤其是涉及发送交易的代码前养成在测试网或本地分叉环境利用surfpool先行测试的习惯。随着你更频繁地使用这些技能你会和 AI 形成更佳的默契能够更精准地描述需求从而获得更高质量的输出真正实现人机协同的高效开发。