148 lines
5.4 KiB
Markdown
148 lines
5.4 KiB
Markdown
# PROJECT KNOWLEDGE BASE
|
|
|
|
**Generated:** 2026-03-08
|
|
**Updated:** 2026-03-27 (AlphaEar Finance + Cleanup)
|
|
**Type:** OpenCode Skills Collection - Website Generator + SEO + Finance AI
|
|
|
|
---
|
|
|
|
## OVERVIEW
|
|
|
|
Personal collection of OpenCode skills for AI-powered terminal coding assistant. **60 SKILLS TOTAL.**
|
|
|
|
### **Core Features:**
|
|
- ✅ **Auto-deploy system** - Gitea + Easypanel integration (Dockerfile)
|
|
- ✅ **Unified credentials** - Single .env for all skills
|
|
- ✅ **PDPA compliance** - Thai law-compliant websites with legal templates
|
|
- ✅ **MiniMax API** - TTS, Music, Video, Image generation
|
|
- ✅ **Deployment automation** - Easypanel with Docker containers
|
|
- ✅ **Working cookie consent** - Actually blocks/enables cookies based on user choice
|
|
|
|
### **SEO Multi-Channel Marketing:**
|
|
- ✅ **Multi-channel content** - Facebook, Facebook Ads, Google Ads, Blog, X/Twitter
|
|
- ✅ **Thai language support** - Full PyThaiNLP integration
|
|
- ✅ **Analytics integration** - Umami, GA4, GSC, DataForSEO
|
|
- ✅ **Image integration** - Auto-generate/edit images for content
|
|
|
|
### **Finance AI (AlphaEar):**
|
|
- ✅ **alphaear-news** - Real-time finance news (10+ sources)
|
|
- ✅ **alphaear-stock** - A-Share/HK/US stock data
|
|
- ✅ **alphaear-sentiment** - FinBERT/LLM sentiment analysis
|
|
- ✅ **alphaear-predictor** - Kronos time-series forecasting
|
|
- ✅ **alphaear-signal-tracker** - Signal evolution tracking
|
|
- ✅ **alphaear-logic-visualizer** - Draw.io XML finance diagrams
|
|
- ✅ **alphaear-reporter** - Professional financial reports
|
|
- ✅ **alphaear-search** - Web search + local RAG
|
|
- ✅ **alphaear-deepear-lite** - DeepEar Lite API integration
|
|
|
|
---
|
|
|
|
## STRUCTURE
|
|
|
|
```
|
|
opencode-skill/
|
|
├── .env.example # Unified credentials template (ALL skills)
|
|
├── .env # ⚠️ Gitignored - contains actual credentials
|
|
├── README.md # Quick start guide
|
|
├── AGENTS.md # This file
|
|
├── scripts/
|
|
│ └── install-skills.sh # Installs skills to ~/.config/opencode/
|
|
└── skills/ # 60 skills total
|
|
# Website & Deployment
|
|
├── gitea-sync/ # Auto-create Gitea repos & push code
|
|
├── easypanel-deploy/ # Full Python implementation
|
|
└── thai-frontend-dev/ # Astro builder with PDPA templates
|
|
|
|
# SEO Multi-Channel
|
|
├── seo-master/ # Master SEO skill (merged)
|
|
├── seo-multi-channel/ # Generate content for Facebook, Ads, Blog, X
|
|
├── seo-analyzers/ # Thai keyword, readability, quality
|
|
├── seo-data/ # Analytics: Umami, GA4, GSC, DataForSEO
|
|
├── seo-context/ # Per-project context file management
|
|
├── seo-geo/ # AI search optimization
|
|
└── umami/ # Umami Analytics integration
|
|
|
|
# Finance AI (AlphaEar)
|
|
├── alphaear-news/ # Real-time finance news
|
|
├── alphaear-stock/ # A-Share/HK/US stock data
|
|
├── alphaear-sentiment/ # FinBERT/LLM sentiment
|
|
├── alphaear-predictor/ # Kronos forecasting
|
|
├── alphaear-signal-tracker/
|
|
├── alphaear-logic-visualizer/
|
|
├── alphaear-reporter/
|
|
├── alphaear-search/
|
|
└── alphaear-deepear-lite/
|
|
|
|
# Development Skills
|
|
├── frontend-dev/ # Full-stack frontend
|
|
├── fullstack-dev/ # Backend + frontend
|
|
├── android-native-dev/ # Android development
|
|
├── ios-application-dev/ # iOS development
|
|
├── skill-creator/ # Scaffold new skills
|
|
├── testing-master/ # TDD, E2E, Playwright
|
|
├── testing-patterns/ # JS/Python testing patterns
|
|
├── security-auditor/ # Vulnerability scanning
|
|
├── security-coder/ # Secure coding
|
|
├── pentesting/ # SQL injection, SSRF, etc.
|
|
├── architecture/ # C4, ADRs, system design
|
|
├── backend-architect/ # API design, microservices
|
|
├── database-architect/ # Schema modeling
|
|
└── ... (30+ more skills)
|
|
```
|
|
|
|
---
|
|
|
|
## CREDENTIALS
|
|
|
|
### Required
|
|
| Variable | Description |
|
|
|----------|-------------|
|
|
| `MINIMAX_API_KEY` | TTS, Music, Video, Image generation |
|
|
|
|
### Optional
|
|
| Variable | Description |
|
|
|----------|-------------|
|
|
| `GITEA_*` | Git sync features |
|
|
| `EASYPANEL_*` | Auto-deployment |
|
|
| `UMAMI_*` | Analytics |
|
|
| `GA4_*`, `GSC_*` | Google analytics |
|
|
| `DATAFORSEO_*` | Competitor analysis |
|
|
| `JINA_API_KEY` | Content extraction (free tier: 20 req/min without key) |
|
|
| `LLM_*` | AlphaEar LLM config (MiniMax default) |
|
|
|
|
---
|
|
|
|
## COMMANDS
|
|
|
|
```bash
|
|
# Install all skills
|
|
./scripts/install-skills.sh
|
|
|
|
# Create new skill
|
|
python3 skills/skill-creator/scripts/create_skill.py my-skill "Description"
|
|
|
|
# Generate website (auto-deploys)
|
|
python3 skills/thai-frontend-dev/scripts/create_astro_website.py --name "my-site"
|
|
|
|
# Deploy to Easypanel
|
|
python3 skills/easypanel-deploy/scripts/deploy.py --project x --service y --git-url z
|
|
```
|
|
|
|
---
|
|
|
|
## ANTI-PATTERNS
|
|
|
|
- **NEVER** commit `.env` files
|
|
- **NEVER** return images as base64 (save to file)
|
|
- **NEVER** hardcode credentials (use .env)
|
|
- **NEVER** skip error handling in deploy workflows
|
|
|
|
---
|
|
|
|
## NOTES
|
|
|
|
- All 60 skills have scripts (no docs-only skills)
|
|
- AlphaEar skills use MiniMax by default (OpenAI compatible)
|
|
- Embedding models run offline (no API calls)
|
|
- Jina content extraction works without API key (rate limited)
|