# 直觉协议链上交互技能

`AI智能体` `区块链` `Claude Code` `Web3` `智能合约`

# Intuition Agent Skills

[Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[Codex](https://openai.com/codex) 及兼容 AI 智能体的技能包。教会智能体正确与链上 [Intuition 协议](https://intuition.systems) 进行交互。

## 技能列表

| 技能 | 描述 | 安装 |
|------|------|------|
| [intuition](skills/intuition/) | 生成正确 Intuition 协议交易的权威参考 —— ABI、编码、地址、数值计算 | `npx skills add 0xintuition/agent-skills --skill intuition` |

## 快速开始

```bash
# 安装所有技能
npx skills add 0xintuition/agent-skills

# 安装指定技能
npx skills add 0xintuition/agent-skills --skill intuition
```

安装完成后，技能即可在智能体会话中使用。使用 `/intuition` 调用 Intuition 技能。

## 这些技能的作用

Intuition 运行在一条未被 Etherscan 索引的 L3 链上。大语言模型无法发现其 ABI，并且在处理 V2 合约接口时会持续出错（bytes32 ID、仅批量创建、联合曲线）。这些技能通过经过验证的权威知识填补了上述盲点。

**技能生成未签名的交易参数。** 钱包基础设施和签名由开发者自行负责。

## 项目结构

```
agent-skills/
├── skills/
│   └── intuition/        # Intuition 协议技能
│       ├── SKILL.md      # 技能定义（面向智能体）
│       ├── README.md     # 用户文档
│       └── reference/    # 补充参考资料
├── .claude-plugin/
│   └── marketplace.json  # skills.sh 市场清单
├── CLAUDE.md             # 仓库级智能体指令
├── README.md             # 本文件
└── LICENSE
```

## 添加技能

参见 [CONTRIBUTING.md](CONTRIBUTING.md)，了解向本仓库添加新技能的规范。

## 测试

测试文档见 [TESTING.md](TESTING.md)，包括：
- Layer A 确定性 calldata 检查（`scripts/pass2-calldata-verification.sh`）
- Layer A.5 边缘情况 RPC 检查（`scripts/pass2-edge-case-tests.sh`）
- Layer B 用于自主消费和链上集成的提示词套件（`tests/prompts/`）

## 参考资料

- [Intuition 协议](https://intuition.systems)
- [Agent Skills 规范](https://agentskills.io/specification)
- [skills.sh](https://skills.sh) —— 技能发现与排行榜
- [Intuition V2 合约](https://github.com/0xIntuition/intuition-v2/tree/main/contracts/core)

## 许可证

MIT