Communitygithub.com

bg-szy/TOP-SKILLS

Portfolio Buddy 2 개발을 위한 자동 로딩 컨텍스트입니다. React 19 개발, TypeScript, 포트폴리오 분석 기능, 메트릭 계산, 거래 전략 비교 또는 Portfolio Buddy 2 코드베이스 작업과 관련된 모든 작업에 사용하세요. 기술 스택, 알려진 이슈 및 아키텍처 제약 조건이 포함되어 있습니다.

TOP-SKILLS란 무엇인가요?

이 스킬은 Portfolio Buddy 2 프로젝트의 전체 컨텍스트를 AI 어시스턴트(Claude Code, Cursor 등)에 제공하여, 개발자가 React 19, TypeScript, Vite 기반의 포트폴리오 분석 도구를 효과적으로 유지보수하고 개선할 수 있도록 돕습니다. 기술 스택(Tailwind CSS, Chart.js, Supabase, Cloudflare Pages), 아키텍처 제약 조건(컴포넌트 200줄 제한, `any` 타입 금지), 알려진 버그(대용량 업로드 시 Supabase 500 에러) 및 기술 부채(미사용 의존성 Recharts, 과도한 컴포넌트 크기)를 자세히 설명합니다. 또한 최근 추가된 Sortino 비율 계산, 날짜 범위 필터링, 고급 다중 열 정렬 기능과 같은 주요 기능들을 소개합니다. 이 스킬을 로드하면 AI가 Portfolio Buddy 2의 규칙과 컨텍스트를 이해하고, 코드 리팩토링, 버그 수정, 기능 추가 시 일관된 방향으로 작업할 수 있게 됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/marketplace/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)
  • 상태 관리: 일반 React (useState, useMemo, useCallback)
  • 데이터 유틸리티: date-fns (날짜 조작)
  • 백엔드: Supabase (PostgreSQL)
  • 배포: Cloudflare Pages

프로젝트 목적

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

  • 거래 전략과 벤치마크 자산(SPY, GLD) 비교
  • 자산 간 상관관계 행렬 계산 (Spearman 및 Pearson)
  • 위험 메트릭 및 성과 분석 (Sharpe, Sortino, 최대 낙폭 등)
  • CSV를 통한 거래 데이터 업로드 및 결과 시각화
  • 계약 승수 적용으로 선물 거래 메트릭 조정
  • 날짜 범위 필터링으로 특정 기간 분석

알려진 문제 및 기술 부채

현재 기술 부채

  1. 사용되지 않는 의존성: Recharts (11.5KB)가 설치되었지만 한 번도 임포트되지 않음

    • 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줄)
    • 사용자 지정 무위험 수익률을 위한 입력 상태
    • sqrt(365) 계수를 사용한 연간 하방 편차
    • 수정된 분산 계산 (총 수익률로 나누되 음수만 계산하지 않음)
    • 포트폴리오 통계 섹션에 표시 (535줄)
    • 참고: dataUtils.ts에 없음 - 포트폴리오 레벨 컨텍스트로 인해 컴포넌트에 유지됨
  • 날짜 범위 필터링 (커밋 258ba3a)
    • 시작/종료 날짜로 포트폴리오 데이터 필터링
    • usePortfolio 훅에 구현됨
  • 고급 다중 열 정렬 (useSorting 훅)
    • 우선순위에 따라 여러 열로 정렬
    • 열별 사용자 정의 비교 로직

아키텍처 제약 조건

  • 컴포넌트 제한: 컴포넌트당 최대 200줄 (현재 3개 컴포넌트 위반)
  • 훅 패턴: /src/hooks/에 사용자 정의 훅
  • 유틸 패턴: /src/utils/에 순수 함수
  • 타입 안전성: 엄격한 TypeScript, any 타입 금지 (기술 부채로 15개 위반 존재)
  • 상태 관리: 일반 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/에 매핑됨 — 모든 내부 임포트에 사용
  • shadcn-ui: 색상 토큰만 사용 — CSS 변수는 src/index.css에 있으며, 실제 shadcn 컴포넌트는 설치되지 않음. 나중에 npx shadcn@latest add button 등으로 추가 가능
  • Git 워크플로우: 기능 브랜치 → git checkout -b feature/name → 컨벤셔널 커밋 (feat:, fix:, chore:) → main으로 PR
  • 커뮤니티 브랜딩: 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.

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

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.

bg-szy/TOP-SKILLS

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. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

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.

bg-szy/TOP-SKILLS

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.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

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.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

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", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

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.

bg-szy/TOP-SKILLS

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

관련 스킬