区块链开发助手

Stacks代理

构建Stacks区块链应用程序的AI技能——比特币最强大的智能合约层

一个智能AI助手，为Clarity智能合约、DeFi集成和Stacks上的区块链开发提供开发指导。使用 Claude Code、Cursor、Windsurf、Antigravity、GitHub Copilot、Kiro和Codex.

✨ 特性

亮点：

• 🎯 40个生产代码示例 -来自实时dApps的真实代码（sbtc市场、stacksagent、STX City）
• 🕸️ 100种知识关系 -跨领域的互联概念
• 🚫 零废弃代码 -所有现代@stacks/connect v7+neneneba API模式
• 🔒 安全第一示例 -后置条件、错误处理、真正的漏洞

15个领域的557+个知识库条目：

核心语言和工具（175条）

• 🔷 61清晰度功能 -带示例的完整语言参考
• ⚛️ 75 Stacks.js实用程序 -钱包、交易、CV构建器、API集成
• 📋 14合同模板 -SIP-010、SIP-009、DAO、保险库、市场、堆叠
• 🚀 25个部署步骤 -测试网、主网和开发网工作流

领域特定集成（247条）

• 🌐 21 BNS运营 -名称注册、解析（Clarity+JS+API）
• 💰 25个堆叠导轨 -PoX堆叠和池委托（Clarity+JS+API）
• 🔄 87个DeFi协议 -Alex、Velar、Bitflow、USDCx桥接、多DEX路由（Clarity+JS+neneneba API）
• 🎨 30 NFT操作 -SIP-009，铸造，市场模式（Clarity+JS+neneneba API）
• 💎 40代币操作 -SIP-010可替代代币，DeFi集成（Clarity+JS+API）
• 🔐 14身份验证 -钱包身份验证、JWT、会话、令牌门控(没有盖亚 -已弃用）（Clarity+JS+API）
• 📊 30 Oracle集成 -Pyth Network价格提要、VAA处理、Hermes API（Clarity+JS+API）

高级和专业（135条）

• 🛡️ 15种安全模式 -常见漏洞和安全实现
• 🎯 40种高级模式 -分页、SWR、预售、彩票、行权、CSV导出
• 🔗 30个链钩 -事件索引、webhooks、谓词、序数跟踪
• 🤖 50个交易机器人 -自动交易、钱包SDK、Privy、绑定曲线

🎯 用例

• 从自然语言生成Clarity智能合约
• 审计安全漏洞合同
• 与DeFi协议集成（掉期、流动性、贷款）
• 将USDC从以太坊连接到Stacks（USDCx）
• 在多个DEX（Bitflow、Alex、Velar）之间交换USDCx
• 整合Pyth Network oracle获取价格信息
• 部署到测试网/主网
• 使用Stacks.js构建去中心化应用
• 实现堆叠和BNS功能

📦 安装

使用CLI（推荐）

# Install globally
npm install -g stacksagent

# Go to your project
cd /path/to/your/project

# Install for your AI assistant
stacksagent init --ai claude      # Claude Code
stacksagent init --ai cursor      # Cursor
stacksagent init --ai windsurf    # Windsurf
stacksagent init --ai antigravity # Antigravity
stacksagent init --ai copilot     # GitHub Copilot
stacksagent init --ai kiro        # Kiro
stacksagent init --ai codex       # OpenAI Codex
stacksagent init --ai all         # All platforms

手动安装

将相应的文件夹复制到您的项目中：

🚀 用法

克劳德代码

当您请求Stacks开发工作、标记或提及时，该技能会自动激活 stacksagent

Create a meme token called PEPE with 1 billion supply @stacksagent

光标/风帆/反重力

使用斜线命令：

/stacks-agent Create a meme token called PEPE with 1 billion supply

GitHub Copilot

聊天中的参考：

@stacks-agent How do I swap tokens on Alex?

💡 示例提示

基本查询：

"Create a SIP-010 token with burn mechanism"
"Build an NFT collection with royalties"
"Audit this Clarity contract for security issues"
"Deploy my contract to testnet"

生产代码示例（v2.0中新增）：

"Show me a complete working example of swapping tokens with slippage protection"
"How do I connect a wallet using the new @stacks/connect v7 API?"
"Give me production code for NFT marketplace listing"
"Show me how to integrate Pyth oracle for BTC/USD price"
"How do I implement JWT authentication with wallet signatures?"
"Show me a secure token transfer with post-conditions"

USDCx桥接和多DEX（v1.6.0中的新功能）：

"How do I bridge USDC from Ethereum to Stacks?"
"Show me how to swap USDCx to STX on Bitflow"
"How do I get quotes from Alex and Bitflow SDKs?"
"Build a multi-token swap using Bitflow router"
"What are the contract addresses for USDCx on mainnet?"
"Show me a two-step swap pattern: USDCx -> STX -> ALEX"

与关系：

"What are the dependencies for implementing a token swap?"
"Show me all security patterns related to NFT marketplace"
"What JavaScript SDK functions implement Clarity stacking?"

🔍 知识库搜索

该技能包括一个强大的基于BM25的搜索引擎：

# Auto-detect domain
python3 .claude/skills/stacks-agent/scripts/search.py "define-public"

# Search specific domain
python3 .claude/skills/stacks-agent/scripts/search.py "swap tokens" --domain defi

# Get more results
python3 .claude/skills/stacks-agent/scripts/search.py "security" --domain security -n 10

# JSON output
python3 .claude/skills/stacks-agent/scripts/search.py "stx transfer" --domain stacksjs -f json

可用域:

• clarity -语法和函数
• templates -合同模板
• security -安全模式
• defi -DeFi协议（掉期、流动性、堆叠、预言机）
• nfts -NFT运营（铸币、市场、特许权使用费）
• tokens -代币操作（SIP-010、行权、津贴）
• auth -身份验证（钱包连接、JWT、会话）
• stacksjs -JavaScript代码片段
• bns -BNS操作
• stacking -堆叠导轨
• deployment -部署步骤
• auto -自动检测（默认）

🎯 生产代码示例（v2.0中新增）

搜索从实时dApps中提取的40个完整的、经过生产测试的代码示例：

# Search examples
python3 .claude/skills/stacks-agent/scripts/search.py "how to swap" --examples

# Filter by domain
python3 .claude/skills/stacks-agent/scripts/search.py "marketplace" --domain nfts --examples

# Filter by difficulty
python3 .claude/skills/stacks-agent/scripts/search.py "token" --difficulty beginner --examples

# Search specific example type
python3 .claude/skills/stacks-agent/scripts/search.py "debug" --example-type debugging

示例类型

• 快速入门 -单个特征示例（8个示例）
• 整合 -多步骤工作流程（12个示例）
• 调试 -故障排除失败的交易（3个示例）
• 最佳实践 -推荐模式（3个示例）
• 安全 -以安全为重点的实施（2个示例）

示例覆盖范围

DeFi（10个示例）:

• 具有滑点保护的掉期（sbtc市场前端）
• 添加/删除流动性（预测市场）
• Python oracle与VAA的集成
• 将堆叠委托给PoX池
• 债券曲线买入（STX City）
• 多跳交换路由
• 调试失败的交换
• 安全令牌审批

NFT（10个示例）:

• 符合SIP-009标准的铸币/转移
• 市场上市和购买（Gamma模式）
• NFT版税（EIP-2981类）
• 批量铸造空投
• 动态元数据更新
• 收藏启动工作流
• 调试传输失败
• 通过第三方托管确保市场安全

代币（8个示例）:

• 部署SIP-010令牌
• 有岗位条件的安全转账
• 代币额度（DEX集成）
• 带有悬崖期的行权时间表
• 代币燃烧（通货紧缩机制）
• 多代币原子交换
• 调试传输失败

安全（7例）:

• 防止再次进入
• 整数溢出保护
• 访问控制（RBAC）
• 输入验证
• DoS的速率限制
• 安全随机性
• 特权升级预防

Auth（5个示例）:

• 钱包连接流（sbtc市场）
• 通过签名进行JWT身份验证（stacksagent）
• 具有持久性的受保护路线（STX市）
• NFT令牌门控
• 具有清理功能的会话管理

输出格式示例

每个示例包括：

• ✅ 完整的工作代码 从生产dApps
• ✅ 测试输入/输出 使用有效的JSON
• ✅ 常见的陷阱 来自真实的虫子
• ✅ 实时示例URL 到实际代码
• ✅ 现代API模式 （@堆栈/连接v7+）
• ✅ 安全最佳实践 （岗位条件，拒绝模式）

🕸️ 知识图关系（v2.0中的新功能）

100个关系将跨领域的概念联系起来：

# Get related entries for top results
python3 .claude/skills/stacks-agent/scripts/search.py "swap tokens" --include-relationships

# Export relationship graph
python3 -c "from scripts.relationships import get_graph; print(get_graph().export_graph('mermaid'))"

关系类型

• 需要 -关键依赖性（例如，“掉期需要ft转移”）
• 用途 -功能依赖性（例如，“DEX使用后置条件”）
• 实现 -符合标准（例如，“令牌实现SIP-010”）
• javascript用于 -语言桥（例如，“SDK实现了Clarity功能”）
• 防止 -安全防御（例如，“访问控制防止未经授权的访问”）
• 类似于 -替代方法
• 冲突 -不兼容
• 补充物 -共同增强

输出示例

Search: "name-to-address"

Result: bns:1 - name-to-address function

📚 Related Entries:
  [requires] clarity-syntax:59 (strength: 10) - Uses contract-call?
  [javascript-for] bns:12 (strength: 10) - SDK implements resolution
  [uses] security-patterns:1 (strength: 8) - Needs access control

📚 知识库内容

清晰语言（61条）

类型、函数、控制流、算术、比较、映射、令牌、STX操作

合同模板（14个条目）

• 代币：SIP-010基本型，可铸造，可燃，有盖
• NFT：SIP-009基本、可铸造、特许权使用费
• 德菲：保险库基本/时间锁定，流动性池
• 去中心化自治组织：基本DAO，资金管理
• 其他：市场、堆叠池

安全模式（15个条目）

• 关键：访问控制、未经检查的传输
• 高：重入，算术安全
• 媒介：输入验证，前置运行
• 低：代码风格，气体优化

DeFi协议（87个条目）

Alex、Velar、Bitflow、Zest、StackingDAO、Boost、Faktory集成模式

USDCx桥接和多DEX（v1.6.0中的新功能）

桥梁操作：

• 从以太坊存入USDC→ 在Stacks上铸造USDCx
• 在堆栈上燃烧USDCx→ 在以太坊上提取USDC
• 地址编码（堆栈↔ 以太坊）
• 过桥时间：~15分钟存款，~60分钟取款

多DEX交换路由：

• 比特流： swap-helper-a/b/c 适用于2/3/4期权掉期
• 亚历克斯： swap-helper, swap-helper-a 与因素
• 维拉尔： path-apply 基于元组的路由
• Stableswap：stSTX↔STX、USDH↔美元x

报价API：

• 比特流SDK： getQuoteForRoute()
• Alex SDK： getAmountTo() 带货币枚举
• 回退率和价格缓存

合同地址：

Stacks.js（30个条目）

钱包连接、交易、Clarity值、API调用、条件后

BNS（10个条目）

名称解析、注册、转移、更新

堆叠（15个条目）

直接堆叠、委托、池、奖励

部署（25个条目）

使用Clarinet的测试网、主网、开发网工作流

🛡️ 安全最佳实践

所有生成的合同包括：

• ✅ 访问控制(tx-sender 验证）
• ✅ 错误处理(try!, unwrap!)
• ✅ 输入验证(asserts!)
• ✅ 命名错误常量
• ✅ Kebab案例命名
• ✅ 网络兼容性检查

🌐 网络

• 主网：生产（SP…地址）
• 测试网：测试（ST…地址，免费STX）
• 国际信息发展组织：地方发展（Clarinet）

🔧 先决条件

• Python 3.x（用于搜索功能）
• Node.js 18+（用于CLI安装）

python3 --version
node --version

📖 文档

• 堆叠文档
• 清晰度参考
• Hiro平台
• 浏览器（主网）
• 资源管理器（测试网）

🔗 DeFi资源

• Alex DEX
• Velar DEX
• 比特流DEX
• Zest协议
• USDCx桥接文件
• 圆形xReserve

🤝 贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 将知识条目添加到相应的CSV文件中
5. 测试搜索功能
6. 提交拉取请求

📄 许可证

MIT许可证-请参阅 许可证 详细信息文件

🙏 致谢

为Stacks社区打造：

• Stacks.js 由Hiro Systems提供
• Stacks区块链
• 清晰语言

📞 支持

• GitHub问题： 报告错误或请求功能
• 堆叠不一致： 加入社区
• 推特： @kai_builder

🎯 路线图

已完成（v1.6.0）✅

• [x] USDCx从以太坊桥接（62个新条目）
• [x] 多DEX交换路由（Bitflow、Alex、Velar）
• [x] AMM引用API模式（SDK集成）
• [x] 557+个知识库条目

已完成（v2.0）✅

• [x] 多平台AI技能支持（7个平台）
• [x] 495+个知识库条目
• [x] BM25搜索引擎，支持正则表达式增强
• [x] CLI安装程序
• [x] 来自实时dApps的40个生产代码示例
• [x] 100个知识图关系
• [x] 现代API模式（@stacks/connect v7+）
• [x] 弃用代码删除（Gaia、openContractCall、showConnect）

进行中（v2.1）

• []基于Web的搜索界面
• []互动示例游乐场
• []社区示例贡献

未来（v3.0+）

• []VSCode扩展
• []实时合同分析
• []嵌入语义搜索
• []多语言支持（中文、西班牙语）

由...制作❤️ 对于Stacks社区

在人工智能的帮助下构建比特币安全的去中心化应用程序