grimoire
一个用于表达金融意图并跨协议执行的领域特定语言。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：grimoire。 它的用途是：一个用于表达金融意图并跨协议执行的领域特定语言。 完整的 Skill 内容见：https://321skill.com/skills/grimoire/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我用 Grimoire 写一个咒语，当 ETH 在 Uniswap 上的价格低于 3000 美元时，用 1000 USDC 买入。” 它会引导你编写相应的 `.spell` 文件。然后你可以使用 `grimoire simulate` 命令在测试网上预览交易结果，确认无误后，使用 `grimoire cast` 命令在主网上执行该交易。
介绍
Grimoire 是一个为智能体设计的领域特定语言，旨在解决在区块链上编写和执行复杂金融策略时面临的逻辑重复、协议依赖和意图表达模糊的问题。它允许开发者或智能体使用一种可读的语法来定义金融操作（称为“咒语”），这些操作会被编译成中间表示，并通过不同的协议适配器执行，从而实现策略逻辑与底层交易场所的解耦。
使用 Grimoire 时，你可以通过 CLI 或库的形式进行交互。核心流程遵循“先预览，后提交”的原则，确保所有操作在模拟环境中验证无误后再上链执行。CLI 提供了从设置、模拟到真实执行的完整工具链，并支持通过 venue 命令获取实时链上数据作为策略输入。
这个工具非常适合量化交易员、智能体开发者和希望将复杂金融逻辑自动化的区块链开发者。它降低了直接在智能合约层面编码策略的门槛，并提供了一种更安全、可复现的方式来管理和执行交易意图。
建议新用户从官方教程开始，并充分利用 simulate 和 --dry-run 功能来测试咒语。注意，.grimoire/setup.env 文件包含明文私钥等敏感信息，务必妥善保管，避免提交到版本控制系统。
核心特点
与直接调用协议 SDK 或编写智能合约不同，Grimoire 通过声明式的“咒语”语法和协议适配器抽象，实现了金融策略逻辑与执行场所的完全分离，允许用户仅通过修改配置而非重写代码来切换不同的 DeFi 协议或区块链。
注意事项
目前主要专注于金融交易领域，不适合非金融场景的通用自动化或智能体交互。
常见问题
Grimoire 和直接写智能合约有什么区别？
Grimoire 使用高级声明式语法，编译后通过适配器与链上协议交互，无需手动处理合约 ABI 和低级交易构造，且策略逻辑可跨协议复用。
如何安全地管理执行交易所需的私钥？
CLI 支持通过环境变量 (`--key-env`) 传入私钥，或在交互式设置时加密保存到本地 `.grimoire/setup.env` 文件，但该文件为明文，务必本地保管并定期清理。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/grimoire/raw/index.md 读取 grimoire 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/grimoire/raw/index.md（查看排版版本）