Communitygithub.com

sd0xdev/sd0x-harness

포트폴리오 시스템 지식 베이스입니다. 포지션 조회, 라우팅 전략 질문, 공급자 통합에 사용하세요. 일반 코드 탐색(코드 탐색 사용), 코드 리뷰(codex-code-review 사용)에는 사용하지 마세요. 출력: 도메인 특화 분석 및 권장 사항.

sd0x-harness란 무엇인가요?

이 스킬은 포트폴리오 시스템에 대한 심층 지식 베이스 역할을 하는 AI 에이전트 도구입니다. 사용자가 포트폴리오 포지션 조회, 라우팅 전략, 공급자 통합과 같은 도메인 특화 질문을 할 때, 관련 코드 참조와 함께 분석 및 권장 사항을 제공합니다. 주요 기능으로는 REST API(`POST /positions`, `GET /chains`, `GET /protocols`)를 통한 포지션 데이터 조회, 소스 라우터를 통한 데이터 공급자 연결 및 집계 계산이 포함됩니다. Cursor, Codex, Claude Code 등 여러 AI 코딩 도구에서 사용 가능하며, 캐시 적중/실패 확인 및 집계 정확도 검증 지원을 통해 개발자가 포트폴리오 관련 작업을 효율적으로 수행할 수 있도록 돕습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/sd0xdev/sd0x-harness/tree/HEAD/skills/portfolio

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

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

문서

포트폴리오 스킬

트리거

  • 키워드: Portfolio, portfolio, position, {PRIMARY_PROVIDER}, protocol, lending, staking, liquidity

사용하지 말아야 할 경우

  • 일반 토큰 조회(포트폴리오 포지션이 아닌 경우)
  • 트랜잭션 구축(해당 공급자 사용)
  • 포트폴리오와 관련 없는 API 문제

핵심 파일

유형파일목적
컨트롤러src/entity/portfolio/portfolio.controller.tsREST API
라우터src/service/portfolio/source-router/*.service.ts라우팅 오케스트레이션
클라이언트src/service/portfolio/providers/{provider}/*.ts{PRIMARY_PROVIDER} 통합
집계기src/service/portfolio/aggregation/*.service.ts집계 계산
DTOsrc/dto/portfolio/position.types.ts포지션 모델

API 개요

기본 경로: /onchain/v1/portfolio

엔드포인트메서드목적
/positionsPOST포트폴리오 포지션 가져오기
/chainsGET지원 체인 목록
/protocolsGET지원 프로토콜 목록

출력

  • 코드 참조가 포함된 도메인 특화 쿼리 결과
  • 현재 아키텍처 기반 분석 및 권장 사항

검증

  • 포지션 데이터가 올바르게 정규화됨
  • 캐시 적중/실패가 올바르게 작동함
  • 집계 계산이 정확함

개발 가이드

프로토콜 지원 추가

  1. {PRIMARY_PROVIDER}가 이를 지원하는지 확인
  2. 사용자 정의 구축이 필요한 경우: PortfolioPositionExtractor 구현 + 등록 + 라우팅 구성

데이터 소스 추가

  1. ProviderClient + Adapter 구현
  2. SourceRouter에 등록
  3. 라우팅 전략 구성

디버그

redis-cli keys "portfolio:{provider}:*"
redis-cli get "portfolio:{provider}:positions:0x...:v2:..."
curl -X POST /positions -d '{"isForceRefresh": true, ...}'

참조

  • references/architecture.md - 시스템 아키텍처 + 캐시 전략
  • references/api.md - API 참조 + 데이터 모델
  • @docs/features/portfolio/ - 상세 문서

테스트

유형위치
단위test/unit/service/portfolio/
통합test/integration/portfolio/

예시

입력: 포트폴리오 포지션을 어떻게 조회하나요?
동작: POST /positions API + 라우팅 전략 설명
입력: {PRIMARY_PROVIDER} 통합은 어떻게 작동하나요?
동작: {PRIMARY_PROVIDER}Client + {PRIMARY_PROVIDER}Adapter 흐름 설명

관련 스킬