Communitygithub.com

Portfolio Buddy 2 개발 컨텍스트

Portfolio Buddy 2 개발을 위한 자동 로딩 컨텍스트. React 19, TypeScript, 포트폴리오 분석, 지표 계산, 트레이딩 전략 비교 등 모든 작업에 사용합니다. 기술 스택, 알려진 이슈, 아키텍처 제약 사항을 포함합니다.

Portfolio Buddy 2 개발 컨텍스트란 무엇인가요?

이 스킬은 Portfolio Buddy 2 프로젝트의 전체 컨텍스트를 제공하는 AI 에이전트 전용 컨텍스트입니다. React 19, TypeScript, Vite 기반의 프론트엔드와 Supabase 백엔드, Cloudflare Pages 배포 환경을 포함한 기술 스택을 명시합니다. 또한 Sortino 비율 계산, 날짜 범위 필터링, 다중 컬럼 정렬 등 최근 추가된 기능과 함께, 타입 안전성 위반(15개의 `any` 타입), 200라인 초과 컴포넌트(최대 591라인), 미사용 의존성(Recharts) 등의 기술 부채를 상세히 기록하고 있습니다. Claude Code, Cursor, Codex 등 AI 코딩 도구에서 이 스킬을 로드하면 프로젝트 구조와 아키텍처 제약을 이해하고 일관된 코드를 생성할 수 있어, 개발 속도와 코드 품질 향상에 도움을 줍니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aiskillstore/marketplace/tree/HEAD/skills/5minfutures/portfolio-context

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Portfolio Buddy 2 - 프로젝트 컨텍스트

기술 스택

  • 프론트엔드: React 19, TypeScript, Vite
  • UI: Tailwind CSS, shadcn/ui (색상 시스템만 사용)
  • 차트: Chart.js, react-chartjs-2, chartjs 플러그인 (zoom, annotation, date adapter)
  • 상태 관리: Plain React (useState, useMemo, useCallback)
  • 데이터 유틸: date-fns (날짜 조작)
  • 백엔드: Supabase (PostgreSQL)
  • 배포: Cloudflare Pages

프로젝트 목적

투자자 및 선물 트레이더를 위한 포트폴리오 분석 도구:

  • 트레이딩 전략과 벤치마크 자산(SPY, GLD) 비교
  • 자산 간 상관관계 행렬 계산 (Spearman & Pearson)
  • 위험 지표 및 성과 분석 (Sharpe, Sortino, Max DD 등)
  • CSV를 통한 트레이드 데이터 업로드 및 결과 시각화
  • 선물 트레이딩을 위한 계약 승수 적용으로 지표 조정
  • 기간별 분석을 위한 날짜 범위 필터링

알려진 이슈 및 기술 부채

현재 기술 부채

  1. 사용하지 않는 의존성: Recharts (11.5KB) 설치되었지만 import되지 않음

    • package.json에서 제거해야 함
    • 현재 Chart.js 사용 중
  2. 컴포넌트 크기 초과: 200라인 기준 위반

    • PortfolioSection.tsx (591줄) → 서브컴포넌트로 리팩토링 필요
    • App.tsx (351줄) → 섹션을 컴포넌트로 분리 필요
    • MetricsTable.tsx (242줄) → 개선되었지만 여전히 제한 초과
  3. TypeScript 위반: any 타입 15건

    • usePortfolio.ts: 트레이드/지표 타입에 11건
    • useMetrics.ts: 정렬 비교에 4건
    • dataUtils.ts: Metrics 인터페이스에 1건

알려진 버그

  1. Supabase 업로드 오류: 대용량 업로드 시 간헐적 500 오류
    • 커밋 9fb7fdb에서 향상된 오류 처리 추가
    • 업로드 훅의 오류 처리 확인 필요
    • 무료 티어의 행 제한 초과 여부 확인

최근 추가된 기능

  • Sortino 비율 계산 (커밋 258ba3a, 9f25040)
    • 위치: PortfolioSection.tsx에 인라인 구현 (133-158줄)
    • 사용자 지정 무위험 수익률을 위한 risk-free rate 입력 상태
    • sqrt(365) 계수를 사용한 연간화된 하방 편차
    • 수정된 분산 계산 (전체 수익률로 나누며, 음수만 계산하지 않음)
    • 포트폴리오 통계 섹션에 표시 (535줄)
    • 참고: dataUtils.ts에 없음 - 포트폴리오 레벨 컨텍스트로 인해 컴포넌트에 유지
  • 날짜 범위 필터링 (커밋 258ba3a)
    • 시작/종료 날짜로 포트폴리오 데이터 필터링
    • usePortfolio 훅에 구현
  • 고급 다중 컬럼 정렬 (useSorting 훅)
    • 우선순위로 여러 컬럼 정렬
    • 컬럼별 사용자 지정 비교 로직

아키텍처 제약

  • 컴포넌트 제한: 컴포넌트당 최대 200줄 (현재 3개 컴포넌트 위반)
  • 훅 패턴: /src/hooks/에 사용자 정의 훅
  • 유틸 패턴: /src/utils/에 순수 함수
  • 타입 안전성: 엄격한 TypeScript, any 타입 없음 (기술 부채로 15건 위반)
  • 상태 관리: Plain React 훅만 사용 - Zustand 또는 TanStack Query 사용 금지

주요 컴포넌트 구조

src/
├── components/
│   ├── AnalyticsControls.tsx     (Metrics/Portfolio/Correlation 뷰 토글)
│   ├── ContractInput.tsx         (계약 승수 입력)
│   ├── CorrelationHeatmap.tsx    (상관관계 시각화)
│   ├── CorrelationSection.tsx    (상관관계 분석 래퍼)
│   ├── CustomTooltip.tsx         (차트 툴팁)
│   ├── ErrorList.tsx             (오류 표시)
│   ├── Header.tsx                (앱 헤더)
│   ├── MasterContractControl.tsx (모든 항목에 계약 값 적용)
│   ├── MetricsTable.tsx          (지표 표시 및 선택)
│   ├── PortfolioSection.tsx      (포트폴리오 차트 및 분석 - 591줄!)
│   ├── SessionComplete.tsx       (완료 UI)
│   ├── SortableHeader.tsx        (정렬 표시기가 있는 테이블 헤더)
│   ├── UploadedFilesList.tsx     (업로드된 파일 목록)
│   └── UploadSection.tsx         (Supabase로 파일 업로드)
├── hooks/
│   ├── useContractMultipliers.ts (계약 승수 관리)
│   ├── useMetrics.ts             (트레이딩 지표 계산)
│   ├── usePortfolio.ts           (포트폴리오 데이터 및 날짜 필터링)
│   └── useSorting.ts             (고급 다중 컬럼 정렬)
└── utils/
    └── dataUtils.ts              (지표 계산, CSV 파싱, 상관관계)

주요 규칙

  • 경로 별칭: @/는 src/로 매핑 — 모든 내부 import에 사용
  • shadcn-ui: 색상 토큰만 사용 — CSS 변수는 src/index.css에, 실제 shadcn 컴포넌트는 설치되지 않음. npx shadcn@latest add button 등으로 나중에 추가 가능
  • Git 워크플로우: 기능 브랜치 → git checkout -b feature/name → 컨벤셔널 커밋 (feat:, fix:, chore:) → PR to main
  • 커뮤니티 브랜딩: 5minfutures.com 트레이딩 커뮤니티; assets에 Skool 로고; GoHighLevel 폼 내장

마이그레이션 컨텍스트

40개 기능을 이전 앱에서 마이그레이션 중 (90% 완료). 자세한 내용은 migration-tracker 스킬 참조.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

aiskillstore/marketplace

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

aiskillstore/marketplace

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

aiskillstore/marketplace

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

aiskillstore/marketplace

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

aiskillstore/marketplace

This skill helps users extract GitHub repository project details and contributor contact information using keywords, stars, and update dates. Agent should proactively apply this skill when users express needs like search for GitHub projects by keywords, find top open-source contributors in specific domains, extract developer contacts from GitHub repositories, discover trending repositories with high stars, gather contributor profiles and social links for tech recruiting, retrieve GitHub project descriptions and metrics, build developer communities by finding active contributors, search for repositories updated recently, collect personal website and Twitter links of developers, generate targeted leads for developer tools, or track active open-source contributors for collaboration.

aiskillstore/marketplace

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

aiskillstore/marketplace

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

aiskillstore/marketplace

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

aiskillstore/marketplace

Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.). Saves hours of brainstorming and manual checking.

aiskillstore/marketplace

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

aiskillstore/marketplace

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas.

aiskillstore/marketplace

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

aiskillstore/marketplace

Router skill for LLMQuant portfolio workflows. Use when the user needs company profiles, thesis tracking, theme research, watchlist monitoring, or alert management.

aiskillstore/marketplace

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

aiskillstore/marketplace

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

aiskillstore/marketplace

Use for Codex models/pricing, scheduled tasks, skills, settings, setup, troubleshooting, customization, automations, and self-knowledge—including 'you,' 'your,' 'this app,' or 'this coding agent' when they refer to Codex—and for OpenAI APIs/products and ChatGPT Work. Also use for model choice/migration, prompting, SDKs, Responses, Realtime, agents, evals, and Chat/Work/Codex comparisons. Do not use for generic app/software tasks that merely mention Codex.

aiskillstore/marketplace

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

aiskillstore/marketplace

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

aiskillstore/marketplace

Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.

aiskillstore/marketplace

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

관련 스킬