Communitygithub.com

sd0xdev/sd0x-harness

Portfolio-System-Wissensbasis. Verwenden bei: Positionsabfragen, Routing-Strategie-Fragen, Provider-Integration. Nicht für: allgemeine Code-Erkundung (code-explore nutzen), Code-Review (codex-code-review nutzen). Ausgabe: domänenspezifische Analyse + Empfehlungen.

Was ist sd0x-harness?

Dieser Skill dient als spezialisierte Wissensbasis für das Portfolio-System des sd0x-Projekts. Er ermöglicht es KI-Agenten, domänenspezifische Abfragen zu Nutzerpositionen (z. B. Lending, Staking, Liquidität) zu beantworten, Routing-Strategien zu erklären und die Integration von DeFi-Providern (wie {PRIMARY_PROVIDER}) zu beschreiben. Der Skill stellt sicher, dass der Agent die richtigen Code-Dateien referenziert, z. B. Controller, Router, Provider-Clients und Aggregatoren. Er ist für den Einsatz mit Claude Code, Cursor oder ähnlichen KI-Tools optimiert und bietet Trigger-Keywords, klare Anwendungsfälle und eine Abgrenzung zu anderen Skills (z. B. code-explore, codex-code-review). Die Ausgabe umfasst domänenspezifische Analysen, Code-Referenzen und architekturbasierte Empfehlungen.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/sd0xdev/sd0x-harness/tree/HEAD/skills/portfolio

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Portfolio Skill

Auslöser

  • Schlüsselwörter: Portfolio, portfolio, Position, {PRIMARY_PROVIDER}, Protokoll, Lending, Staking, Liquidität

Wann NICHT verwenden

  • Allgemeine Token-Abfragen (keine Portfolio-Positionen)
  • Transaktionserstellung (entsprechenden Provider verwenden)
  • Nicht- Portfolio-bezogene API-Probleme

Kerndateien

TypDateiZweck
Controllersrc/entity/portfolio/portfolio.controller.tsREST-API
Routersrc/service/portfolio/source-router/*.service.tsRouting-Orchestrierung
Clientsrc/service/portfolio/providers/{provider}/*.ts{PRIMARY_PROVIDER}-Integration
Aggregatorsrc/service/portfolio/aggregation/*.service.tsAggregationsberechnung
DTOsrc/dto/portfolio/position.types.tsPositionsmodell

API-Übersicht

Basis: /onchain/v1/portfolio

EndpunktMethodeZweck
/positionsPOSTPortfolio-Positionen abrufen
/chainsGETListe unterstützter Chains
/protocolsGETListe unterstützter Protokolle

Ausgabe

  • Domänenspezifische Abfrageergebnisse mit Code-Referenzen
  • Analyse und Empfehlungen basierend auf der aktuellen Architektur

Überprüfung

  • Positionsdaten korrekt normalisiert
  • Cache-Hit/Miss funktioniert ordnungsgemäß
  • Aggregationsberechnungen korrekt

Entwicklungsanleitung

Protokollunterstützung hinzufügen

  1. Prüfen, ob {PRIMARY_PROVIDER} dies unterstützt
  2. Falls benutzerdefinierter Build erforderlich: PortfolioPositionExtractor implementieren + registrieren + Routing konfigurieren

Datenquelle hinzufügen

  1. ProviderClient + Adapter implementieren
  2. Bei SourceRouter registrieren
  3. Routing-Strategie konfigurieren

Debuggen

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

Referenzen

  • references/architecture.md - Systemarchitektur + Cache-Strategie
  • references/api.md - API-Referenz + Datenmodelle
  • @docs/features/portfolio/ - Detaillierte Dokumentation

Tests

TypOrt
Unittest/unit/service/portfolio/
Integrationtest/integration/portfolio/

Beispiele

Eingabe: Wie frage ich Portfolio-Positionen ab?
Aktion: POST /positions API + Routing-Strategie erklären
Eingabe: Wie funktioniert die {PRIMARY_PROVIDER}-Integration?
Aktion: {PRIMARY_PROVIDER}Client + {PRIMARY_PROVIDER}Adapter-Ablauf erklären

Verwandte Skills