pinescript-agents

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# Pine Script Development Assistant for Claude Code

A comprehensive Pine Script development environment powered by Claude Code's Skills system. This tool helps you create professional TradingView indicators and strategies with AI assistance.

**Just type `start` to begin!**

## 🚀 Quick Start

1. **Clone the repository**
   ```bash
   git clone https://github.com/TradersPost/pinescript-agents.git
   cd pinescript-agents
   ```

2. **Install dependencies** (for YouTube video analysis)
   ```bash
   pip install -r requirements.txt

   # Also need FFmpeg for audio processing (optional, for Whisper fallback)
   # macOS: brew install ffmpeg
   # Ubuntu: sudo apt install ffmpeg
   ```

3. **Open in your IDE with Claude Code**
   ```bash
   # VS Code with Claude extension
   code .

   # Or use Claude Code CLI
   claude
   ```

4. **Just type "start" in Claude chat**
   ```
   start
   ```
   This launches an interactive guide that helps you:
   - Create custom scripts
   - Analyze YouTube videos
   - Choose from templates
   - Understand system capabilities

5. **Or jump straight to creating**
   ```
   Create an RSI divergence indicator with alerts
   Build a mean reversion strategy using Bollinger Bands
   Analyze this video: https://youtube.com/watch?v=...
   ```

   **Other helpful commands:**
   - `help` - Show all available commands
   - `examples` - List example scripts
   - `templates` - Show quick templates
   - `status` - Show system status and available skills

## 🎯 Specialized AI Skills

This project uses Claude Code's **Skills system** - specialized capabilities that **automatically activate** based on your request. No explicit commands needed!

### How Skills Work

1. **Automatic Discovery**: Skills are loaded when you open the project
2. **Context-Based Activation**: Claude reads your request and activates the appropriate skill
3. **Seamless Integration**: Skills feel like natural capabilities, not separate tools

### Available Skills

| Skill | Activates When You... | What It Does |
|-------|----------------------|--------------|
| 📊 **pine-visualizer** | Ask conceptual questions, share YouTube videos, say "how would I build" | Breaks down trading ideas into implementable components |
| 💻 **pine-developer** | Say "create", "write", "implement", "code" | Writes production-quality Pine Script v6 code |
| 🐛 **pine-debugger** | Say "debug", "fix", "error", "not working" | Adds debugging tools and troubleshoots issues |
| 📈 **pine-backtester** | Say "backtest", "metrics", "win rate", "performance" | Implements comprehensive testing capabilities |
| ⚡ **pine-optimizer** | Say "optimize", "faster", "improve", "better UX" | Enhances performance and user experience |
| 🎯 **pine-manager** | Have complex multi-part requests, say "complete trading system" | Orchestrates complex multi-step development |
| 📝 **pine-publisher** | Say "publish", "release", "documentation" | Prepares scripts for TradingView publication |

### Skill Activation Examples

```
You: "Create an RSI indicator"
→ pine-developer skill activates automatically

You: "My script has errors"
→ pine-debugger skill activates automatically

You: "How would I build a mean reversion strategy?"
→ pine-visualizer skill activates automatically

You: "Build a complete trading system with backtesting"
→ pine-manager skill orchestrates multiple skills
```

## 📁 Project Structure

```
pinescript-agents/
├── .claude/
│   ├── skills/          # AI skill configurations (SKILL.md files)
│   ├── commands/         # Slash commands (start, create, video, etc.)
│   └── hooks/            # System hooks for commands
├── docs/
│   ├── docs/             # User guide (concepts, language, FAQ, errors)
│   ├── manual/           # Complete Pine Script v6 reference
│   └── server/           # MCP documentation server
├── templates/            # Ready-to-use templates
│   ├── indicators/       # Indicator templates
│   ├── strategies/       # Strategy templates
│   └── utilities/        # Helper functions
├── projects/             # Your Pine Script projects
├── examples/             # Example scripts
├── tools/                # Utility scripts
├── CLAUDE.md             # Claude Code instructions
└── CHANGELOG.md          # Version history
```

## 💡 Usage Examples

### Quick Commands
Just type these single words in Claude chat:
- `start` - Launch interactive setup guide
- `help` - Show available commands
- `status` - Show system status and available skills
- `examples` - List all example scripts
- `templates` - Show quick templates
- `lock` - Protect system files (only `/projects/` writable)
- `unlock` - Allow all file modifications

### Analyze a YouTube Video
```
You: Analyze this video: https://youtube.com/watch?v=...
Claude: [pine-visualizer extracts transcript, identifies components, creates specification]
```

### Create a Simple Indicator
```
You: "Create a moving average crossover indicator"
Claude: [pine-developer creates the indicator with proper inputs and alerts]
```

### Build a Complex Strategy
```
You: "Build a strategy that combines RSI, MACD, and volume analysis with proper risk management"
Claude: [pine-manager coordinates multiple skills for complete implementation]
```

### Debug Existing Code
```
You: "My script is repainting, help me fix it"
Claude: [pine-debugger identifies and fixes repainting issues]
```

### Optimize Performance
```
You: "Make my script load faster"
Claude: [pine-optimizer improves calculation efficiency]
```

### Prepare for Publishing
```
You: "Prepare my script for TradingView publication"
Claude: [pine-publisher adds documentation and ensures compliance]
```

## 📚 Available Templates

### Indicators
- **RSI Divergence** — RSI with bullish/bearish divergence detection
- **Multi-Timeframe** — Multi-timeframe analysis indicator
- **Support & Resistance** — Key level identification
- **VWAP Bands** — VWAP with standard deviation bands
- **RSI Basic** — Simple RSI momentum indicator

### Strategies
- **Breakout** — Range breakout entry system
- **Mean Reversion** — Oversold/overbought reversal system
- **Momentum** — Momentum-based entry strategy
- **MA Cross** — Moving average crossover strategy

### Utilities
- **Debug Panel** — Label and table debugging tools
- **Risk Manager** — Position sizing and stop losses
- **Session Filter** — Trading session time filters

## 🗣️ Natural Language Interface

No need for complex commands! Just talk to Claude naturally:

- **Simple words trigger actions**: Type `start`, `help`, `status`, `examples`
- **Describe what you want**: "Create a strategy that buys on RSI oversold"
- **Share videos**: "Analyze this YouTube video: [URL]"
- **Ask for help**: "What can you do?" or "Show me examples"

Skills activate automatically based on what you're trying to accomplish.

## 🎯 Key Features

- **Pine Script v6 Support**: Full compatibility with latest Pine Script version
- **Intelligent Workflow**: Automatic skill activation based on task context
- **Template Library**: Pre-built components for rapid development
- **Debug Tools**: Built-in debugging capabilities
- **Performance Metrics**: Comprehensive backtesting statistics
- **Publication Ready**: Scripts prepared for TradingView community
- **File Protection**: Lock system files while developing in `/projects/`

## 🛠️ Development Workflow

1. **Describe Your Idea**: Tell Claude what you want to create
2. **Automatic Planning**: Skills break down requirements
3. **Implementation**: Code is written following best practices
4. **Testing**: Debug tools and backtesting added
5. **Optimization**: Performance and UX enhanced
6. **Delivery**: Complete, production-ready script

## 📋 Best Practices

- Always test scripts on multiple timeframes
- Include proper error handling
- Add tooltips to all inputs
- Document complex logic
- Avoid repainting issues
- Optimize for performance
- Follow TradingView guidelines

## 🚨 Common Commands

| Command | What Happens |
|---------|--------------|
| `"Create indicator"` | pine-developer activates for implementation |
| `"Create strategy"` | pine-developer activates with strategy focus |
| `"Debug my script"` | pine-debugger activates for troubleshooting |
| `"Add backtesting"` | pine-backtester adds performance metrics |
| `"Optimize performance"` | pine-optimizer improves efficiency |
| `"Prepare for publishing"` | pine-publisher adds documentation |
| `"Build complete system"` | pine-manager orchestrates full workflow |

## 📖 Documentation

- [Pine Script v6 Reference](https://github.com/traderspost/pinescript-agents/blob/HEAD/docs/manual/pinescriptv6_complete_reference.md)
- [User Guide](https://github.com/traderspost/pinescript-agents/blob/HEAD/docs/docs/index.md)
- [Skill Documentation](https://github.com/traderspost/pinescript-agents/tree/HEAD/.claude/skills/)
- [Changelog](https://github.com/traderspost/pinescript-agents/blob/HEAD/CHANGELOG.md)

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch
3. Add new templates or improve skills
4. Submit a pull request

## 📄 License

MIT License - feel free to use this project for any purpose.

## 🙏 Acknowledgments

- Built for use with [Claude Code](https://claude.ai/code)
- Powered by Claude Code's Skills system
- Designed for [TradingView](https://www.tradingview.com) Pine Script v6
- Community contributions and feedback

## 💬 Support

For issues, questions, or suggestions:
- Open an issue on GitHub
- Check existing documentation
- Review example scripts

---

**Ready to create professional Pine Scripts?** Open this project in Claude Code and start building!

Pine Script Development Assistant for Claude Code

A comprehensive Pine Script development environment powered by Claude Code's Skills system. This tool helps you create professional TradingView indicators and strategies with AI assistance.

Just type start to begin!

🚀 Quick Start

Clone the repository

git clone https://github.com/TradersPost/pinescript-agents.git
cd pinescript-agents

Install dependencies (for YouTube video analysis)

pip install -r requirements.txt

# Also need FFmpeg for audio processing (optional, for Whisper fallback)
# macOS: brew install ffmpeg
# Ubuntu: sudo apt install ffmpeg

Open in your IDE with Claude Code

# VS Code with Claude extension
code .

# Or use Claude Code CLI
claude

Just type "start" in Claude chat
```
start
```
This launches an interactive guide that helps you:
- Create custom scripts
- Analyze YouTube videos
- Choose from templates
- Understand system capabilities
Or jump straight to creating
```
Create an RSI divergence indicator with alerts
Build a mean reversion strategy using Bollinger Bands
Analyze this video: https://youtube.com/watch?v=...
```
Other helpful commands:
- help - Show all available commands
- examples - List example scripts
- templates - Show quick templates
- status - Show system status and available skills

🎯 Specialized AI Skills

This project uses Claude Code's Skills system - specialized capabilities that automatically activate based on your request. No explicit commands needed!

How Skills Work

Automatic Discovery: Skills are loaded when you open the project
Context-Based Activation: Claude reads your request and activates the appropriate skill
Seamless Integration: Skills feel like natural capabilities, not separate tools

Available Skills

Skill	Activates When You...	What It Does
📊 pine-visualizer	Ask conceptual questions, share YouTube videos, say "how would I build"	Breaks down trading ideas into implementable components
💻 pine-developer	Say "create", "write", "implement", "code"	Writes production-quality Pine Script v6 code
🐛 pine-debugger	Say "debug", "fix", "error", "not working"	Adds debugging tools and troubleshoots issues
📈 pine-backtester	Say "backtest", "metrics", "win rate", "performance"	Implements comprehensive testing capabilities
⚡ pine-optimizer	Say "optimize", "faster", "improve", "better UX"	Enhances performance and user experience
🎯 pine-manager	Have complex multi-part requests, say "complete trading system"	Orchestrates complex multi-step development
📝 pine-publisher	Say "publish", "release", "documentation"	Prepares scripts for TradingView publication

Skill Activation Examples

You: "Create an RSI indicator"
→ pine-developer skill activates automatically

You: "My script has errors"
→ pine-debugger skill activates automatically

You: "How would I build a mean reversion strategy?"
→ pine-visualizer skill activates automatically

You: "Build a complete trading system with backtesting"
→ pine-manager skill orchestrates multiple skills

📁 Project Structure

pinescript-agents/
├── .claude/
│   ├── skills/          # AI skill configurations (SKILL.md files)
│   ├── commands/         # Slash commands (start, create, video, etc.)
│   └── hooks/            # System hooks for commands
├── docs/
│   ├── docs/             # User guide (concepts, language, FAQ, errors)
│   ├── manual/           # Complete Pine Script v6 reference
│   └── server/           # MCP documentation server
├── templates/            # Ready-to-use templates
│   ├── indicators/       # Indicator templates
│   ├── strategies/       # Strategy templates
│   └── utilities/        # Helper functions
├── projects/             # Your Pine Script projects
├── examples/             # Example scripts
├── tools/                # Utility scripts
├── CLAUDE.md             # Claude Code instructions
└── CHANGELOG.md          # Version history

💡 Usage Examples

Quick Commands

Just type these single words in Claude chat:

start - Launch interactive setup guide
help - Show available commands
status - Show system status and available skills
examples - List all example scripts
templates - Show quick templates
lock - Protect system files (only /projects/ writable)
unlock - Allow all file modifications

Analyze a YouTube Video

You: Analyze this video: https://youtube.com/watch?v=...
Claude: [pine-visualizer extracts transcript, identifies components, creates specification]

Create a Simple Indicator

You: "Create a moving average crossover indicator"
Claude: [pine-developer creates the indicator with proper inputs and alerts]

Build a Complex Strategy

You: "Build a strategy that combines RSI, MACD, and volume analysis with proper risk management"
Claude: [pine-manager coordinates multiple skills for complete implementation]

Debug Existing Code

You: "My script is repainting, help me fix it"
Claude: [pine-debugger identifies and fixes repainting issues]

Optimize Performance

You: "Make my script load faster"
Claude: [pine-optimizer improves calculation efficiency]

Prepare for Publishing

You: "Prepare my script for TradingView publication"
Claude: [pine-publisher adds documentation and ensures compliance]

📚 Available Templates

Indicators

RSI Divergence — RSI with bullish/bearish divergence detection
Multi-Timeframe — Multi-timeframe analysis indicator
Support & Resistance — Key level identification
VWAP Bands — VWAP with standard deviation bands
RSI Basic — Simple RSI momentum indicator

Strategies

Breakout — Range breakout entry system
Mean Reversion — Oversold/overbought reversal system
Momentum — Momentum-based entry strategy
MA Cross — Moving average crossover strategy

Utilities

Debug Panel — Label and table debugging tools
Risk Manager — Position sizing and stop losses
Session Filter — Trading session time filters

🗣️ Natural Language Interface

No need for complex commands! Just talk to Claude naturally:

Simple words trigger actions: Type start, help, status, examples
Describe what you want: "Create a strategy that buys on RSI oversold"
Share videos: "Analyze this YouTube video: [URL]"
Ask for help: "What can you do?" or "Show me examples"

Skills activate automatically based on what you're trying to accomplish.

🎯 Key Features

Pine Script v6 Support: Full compatibility with latest Pine Script version
Intelligent Workflow: Automatic skill activation based on task context
Template Library: Pre-built components for rapid development
Debug Tools: Built-in debugging capabilities
Performance Metrics: Comprehensive backtesting statistics
Publication Ready: Scripts prepared for TradingView community
File Protection: Lock system files while developing in /projects/

🛠️ Development Workflow

Describe Your Idea: Tell Claude what you want to create
Automatic Planning: Skills break down requirements
Implementation: Code is written following best practices
Testing: Debug tools and backtesting added
Optimization: Performance and UX enhanced
Delivery: Complete, production-ready script

📋 Best Practices

Always test scripts on multiple timeframes
Include proper error handling
Add tooltips to all inputs
Document complex logic
Avoid repainting issues
Optimize for performance
Follow TradingView guidelines

🚨 Common Commands

Command	What Happens
`"Create indicator"`	pine-developer activates for implementation
`"Create strategy"`	pine-developer activates with strategy focus
`"Debug my script"`	pine-debugger activates for troubleshooting
`"Add backtesting"`	pine-backtester adds performance metrics
`"Optimize performance"`	pine-optimizer improves efficiency
`"Prepare for publishing"`	pine-publisher adds documentation
`"Build complete system"`	pine-manager orchestrates full workflow

📖 Documentation

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch
Add new templates or improve skills
Submit a pull request

📄 License

MIT License - feel free to use this project for any purpose.

🙏 Acknowledgments

Built for use with Claude Code
Powered by Claude Code's Skills system
Designed for TradingView Pine Script v6
Community contributions and feedback

💬 Support

For issues, questions, or suggestions:

Open an issue on GitHub
Check existing documentation
Review example scripts

Ready to create professional Pine Scripts? Open this project in Claude Code and start building!