Lighter 交易技能包
让 AI 代理直接在 Lighter（及 Robinhood Lighter）永续与现货市场上查询行情并下单交易的技能。
SKILL.md 明确区分读写命令、强制凭证文件/环境变量不得回显、将 close_all/account mode/withdraw 等高风险操作标记为需用户明确确认、拒绝跨账户转账与密钥轮换等危险能力，并给出 paper.py 无风险模拟和回滚说明（rm -rf .vendor）。扣分项：写入命令即时签名广播、真实资金不可逆，最小权限依赖宿主 agent 的工具审批机制而非技能内强制确认；首次调用从 PyPI/GitHub 拉取 pinned lighter-sdk，供应链信任依赖 pin 而非本地审计。
文档自洽，统一 JSON 错误信封、--help、bootstrap 诊断脚本、health.py 自检，且仓库附带覆盖 paper 状态序列化/损坏恢复/符号缓存/trade 编排的离线测试，错误信息具体（corrupted/version mismatch 等）。扣分项：静态审查未执行任何测试，无 CI 证据文件，live 写路径与真实 API 的失败反馈只能从文档推断。
触发词明确（Lighter/zkLighter/perps/持仓/PnL），平台兼容性、claude.ai 沙箱限制、符号约定、不适用边界（子账户、跨账户、API key 轮换）均有清晰声明。扣分项：核心功能完全依赖境外服务（pypi.org、github.com、lighter 各主机），对中国大陆网络可达性无任何说明或备用方案。
文档分层良好：SKILL.md 精炼、references/ 承载 schema、README 提供安装与命令索引，MIT 许可明确、版本通过 GitHub release 分发、免责声明到位。扣分项：无 CHANGELOG、维护责任与更新路径仅在 README 隐含，发布者未经注册表验证，references/ 内容未在本次源文件中提供。
目标清晰（AI agent 查询与交易 Lighter），人工单位参数、精度回显、paper/live 引擎可互换设计对边际价值有实际支撑。扣分项：静态审查无法验证输出可直接使用，收益与替代方案对比缺乏独立证据。
仓库包含针对关键路径（paper 记账、状态恢复、符号缓存、trade 编排）的离线测试与可复现的 sanity check 命令。扣分项：未见 CI workflow 证据、测试未执行、第三方佐证缺失，超出静态可审计范围的主张（平台支持、安装时长）无法核实。
- 该技能可执行真实、不可逆的加密货币下单/提现/转账，务必先在 testnet 或 paper.py 上验证，绝不自动授权高额 API key。
- 依赖 pypi.org、github.com 及 Lighter 境外主机，中国大陆网络环境可能无法完成安装或调用；claude.ai 沙箱需扩展 egress 白名单。
- order close_all、account mode、account collateral 等账户级操作风险极高，非 preview 形式必须逐条获得用户明确确认。
- 发布者未经 FollowSkills 注册表验证，首次运行会从 PyPI/GitHub 安装依赖，建议审计 requirements.lock 与 pinned lighter-sdk 后再用于实盘资金。
这个 Skill 能做什么，适合哪些场景？
Lighter Agent Kit 是一个面向 AI 代理的技能包，把 Lighter 去中心化交易所的全部交易能力封装成三个 Python 脚本：query.py 负责行情与账户读取，trade.py 负责签名写入（下单、撤单、杠杆、提现等），paper.py 提供基于真实订单簿快照的本地模拟盘。它同时支持 Lighter 主网/测试网和 Robinhood Chain 部署，所有命令以 `<group> <action>` 语法运行并输出结构化 JSON。公共行情无需任何凭证，账户私有读取与写入需要配置 Lighter API 密钥。该技能适合已有 Lighter 账户、希望通过 Claude Code 等代理用自然语言管理交易的量化或加密交易用户。
读取订单簿、最近成交、OHLCV K 线（1m–1d）、资金费率、市场元数据和账户余额/持仓；执行限价单与市价单（含 reduce_only、post_only、默认 1% 滑点预算）、改单、撤单、cancel_all、close_all 一键平仓、设置杠杆与逐仓保证金、统一保证金模式与抵押品开关、以及自己账户内 perp/spot 资金桶之间的划转和提现；还提供 paper.py 本地模拟盘（仅永续、仅市价和 IOC 单），对真实订单簿快照撮合但不动真实资金。命令在写入前自动将人类可读的价格/数量换算为整数 tick/lot，并在响应中回显 effective_amount/effective_price。
- 加密交易者想用自然语言问代理“BTC 和 ETH 哪个点差更窄”并直接下单，而不切换到网页端
- 量化用户在真实启用前，用 paper.py 对实时订单簿快照回测/演练动量策略，零风险零凭证
- 持仓监控者定期拉取 portfolio performance 和 funding rates，筛选年化超过阈值的资金费率
- 同时使用 Lighter 和 Robinhood Lighter 的用户用同一套命令在两个部署间操作（切换 LIGHTER_HOST 即可）
- 需要批量管理挂单的交易者用 cancel_all 或带 --preview 的 close_all 一次性清理账户
这个 Skill 有哪些优点和局限？
- 功能覆盖完整：行情、下单、杠杆、保证金、划转、提现一站式，公共读取完全免凭证
- paper.py 模拟盘使用真实订单簿快照，可在不广播、不要密钥的情况下演练交易
- 所有输出为结构化 JSON，错误统一为 {"error": ...}，便于代理解析和脚本化
- 同时支持 Lighter 与 Robinhood Lighter、主网与测试网，靠一个环境变量切换
- 依赖全部锁定（requirements.lock）并 vendor 在技能目录内，卸载只需删除 .vendor 目录
- 不支持 Intel Mac（darwin-x86_64），平台仅限 macOS arm64 和 Linux x86_64/arm64
- claude.ai 沙箱无法持久导出环境变量，账户私有读取在该环境实际不可用，且默认出口白名单不含 github.com
- paper 模拟盘限制明显：无 maker 成交、不动真实订单簿、无资金费率结算、仅逐仓交叉保证金、仅永续/市价与 IOC 单，模拟与实盘 PnL 会 diverge
- 不支持子账户划转、跨账户转账和 API key 轮换——后者需以太坊私钥，风险高被有意排除
- 提现并非即时到账，需经过 Lighter 的 pending/claim 流程；来源中未提及自动化测试套件
如何安装这个 Skill？
一行安装：curl -fsSL https://github.com/elliottech/lighter-agent-kit/releases/latest/download/install.sh | bash，安装器会检测平台（macOS arm64、Linux x86_64/arm64）、按需装 Python 并注册到所选代理；重启代理会话后生效。手动安装：git clone https://github.com/elliottech/lighter-agent-kit ~/.agents/skills/lighter-agent-kit，再为 Claude Code 软链到 ~/.claude/skills/lighter-agent-kit/（项目级则放 .claude/skills/）。首次调用时 lighter-sdk 会自动 vendor 到技能目录内。需要写入功能时，在 app.lighter.xyz/apikeys 生成 API 密钥并运行 ./lighter-config 写入 ~/.lighter/lighter-agent-kit/credentials，或直接导出 LIGHTER_API_PRIVATE_KEY / LIGHTER_ACCOUNT_INDEX / LIGHTER_API_KEY_INDEX。
如何使用这个 Skill？
用自然语言触发即可，例如：“列出当前资金费率，标出年化超过 10% 的”或“以中间价下方 $50 限价买入 0.01 ETH”。也可直接运行脚本：python3 scripts/query.py market book BTC --limit 10、python3 scripts/trade.py order limit BTC --side long --amount 0.01 --price 60000、python3 scripts/paper.py init && python3 scripts/paper.py order market BTC --side long --amount 0.1。符号规则：永续用裸代码（BTC），现货用带 / 的交易对（ETH/USDC），无需 --market_type。高影响命令（close_all、account mode、account collateral）须先 --preview/查看账户并获得用户明确确认。