# Polymarket交易应用配置

`交易` `Polymarket` `Claude Code` `自动化` `量化交易`

# Polymarket 交易应用 - Claude Code 配置

本目录包含使用 Claude Code 构建 Polymarket 交易应用所需的全部配置文件。

## 快速开始

### 1. 创建项目

```bash
mkdir polymarket-trader
cd polymarket-trader
git init
```

### 2. 复制配置文件

将本目录中的所有文件复制到项目根目录：

```bash
# 复制全部文件
cp -r /path/to/polymarket-setup/* .
cp -r /path/to/polymarket-setup/.* .
```

或手动复制：
- `CLAUDE.md` → 项目根目录
- `.claude/` → 项目根目录（包含技能和命令）
- `.mcp.json` → 项目根目录（用于 MCP 服务器集成）

### 3. 启动 Claude Code

```bash
claude
```

### 4. 初始化项目

在 Claude Code 中运行：
```
/project:init-polymarket
```

这将自动搭建完整的项目结构。

## 目录结构

```
polymarket-setup/
├── CLAUDE.md                          # Claude 主项目上下文
├── .mcp.json                          # MCP 服务器配置
├── .claude/
│   ├── commands/                      # 自定义斜杠命令
│   │   ├── init-polymarket.md         # 初始化项目结构
│   │   ├── add-feature.md             # 添加新功能
│   │   ├── add-strategy.md            # 创建交易策略
│   │   ├── run-backtest.md            # 执行回测
│   │   └── debug-trading.md           # 调试交易问题
│   └── skills/                        # 自定义技能
│       ├── polymarket-api/
│       │   └── SKILL.md               # Polymarket API 集成指南
│       ├── trading-strategies/
│       │   └── SKILL.md               # 策略开发框架
│       └── trader-analysis/
│           └── SKILL.md               # 交易员追踪与分析
└── README.md                          # 本文件
```

## 可用命令

配置完成后，以下斜杠命令可在 Claude Code 中使用：

| 命令 | 描述 |
|------|------|
| `/project:init-polymarket` | 搭建完整项目结构 |
| `/project:add-feature [描述]` | 添加新功能 |
| `/project:add-strategy [名称]` | 创建交易策略 |
| `/project:run-backtest [策略] [选项]` | 运行回测 |
| `/project:debug-trading [问题]` | 调试交易问题 |

## 自定义技能

这些技能为 Claude 提供专业知识：

### polymarket-api
Polymarket CLOB API、Gamma API 及区块链集成综合指南，包括：
- 认证模式
- 订单下达与管理
- WebSocket 订阅
- 价格计算
- 错误处理

### trading-strategies
构建、测试和部署交易策略的框架：
- BaseStrategy 基类
- 信号生成
- 仓位规模控制
- 风险管理
- 回测框架

### trader-analysis
发现并跟随成功交易员的工具：
- 交易员指标计算
- 评分系统
- 跟单交易实现
- 实时监控

## 与 Anthropic 官方技能配合使用

可将官方 Anthropic 技能与这些自定义技能结合使用：

```bash
# 在 Claude Code 中
/plugin marketplace add anthropics/skills
/plugin install frontend-design@anthropic-agent-skills
```

本项目推荐的官方技能：
- **frontend-design** - 用于构建 React 仪表盘
- **webapp-testing** - 用于自动化测试
- **mcp-builder** - 如需自定义 MCP 服务器

## 环境准备

开始构建前，请确保具备：

1. **Polymarket 凭证**：
   - 从 Polymarket 导出私钥
   - 通过派生接口生成 API 凭证

2. **基础设施**：
   - 安装了 TimescaleDB 的 PostgreSQL
   - 用于缓存和 Celery 的 Redis

3. **Node.js 与 Python**：
   - Node.js 18+
   - Python 3.11+

## 最佳实践建议

1. **先规划再编码**：让 Claude 在编码前说明其实现思路
2. **使用计划模式**：按两次 Shift+Tab 进入计划模式
3. **频繁提交**：每完成一个功能后让 Claude 提交代码
4. **运行测试**：继续下一步前始终通过测试验证
5. **单次专注一个功能**：每次聚焦单一功能以获得最佳效果

## 参考资源

- [Polymarket CLOB API 文档](https://docs.polymarket.com/)
- [py-clob-client GitHub](https://github.com/Polymarket/py-clob-client)
- [Polymarket Agents 仓库](https://github.com/Polymarket/agents)
- [Claude Code 最佳实践](https://www.anthropic.com/engineering/claude-code-best-practices)
- [Anthropic Skills 仓库](https://github.com/anthropics/skills)

## 支持

遇到问题时：
- **Claude Code**：查阅 [Claude 文档](https://docs.claude.com/)
- **Polymarket API**：加入 [Polymarket Discord](https://discord.gg/polymarket) 的 #devs 频道
- **本配置**：在项目仓库中提交 Issue

---

祝交易顺利！🚀