Communitygithub.com

sd0xdev/sd0x-harness

Base de connaissances du système de portefeuille. À utiliser pour : requêtes de positions, questions de stratégie de routage, intégration de fournisseurs. Ne pas utiliser pour : exploration générale de code (utiliser code-explore), revue de code (utiliser codex-code-review). Résultat : analyse spécifique au domaine + recommandations.

Qu'est-ce que sd0x-harness ?

Cette compétence fournit une base de connaissances spécialisée pour interroger et comprendre l'état du portefeuille au sein du système sd0x-harness. Elle est conçue pour les développeurs et les agents d'IA qui ont besoin d'extraire des informations détaillées sur les positions de portefeuille, de comprendre la stratégie de routage entre les différentes sources de données, et de travailler avec l'intégration de fournisseurs comme {PRIMARY_PROVIDER}. La compétence gère des scénarios tels que les requêtes de positions, les vérifications de soutien de protocole (lending, staking, liquidité), et le débogage via des commandes Redis et des appels API directs. Elle n'est pas destinée à l'exploration générale de code ou à la revue de code, ces tâches étant confiées à d'autres compétences dédiées. En sortie, elle produit des analyses spécifiques au domaine, des extraits de code, et des recommandations architecturales, appuyées par une structure de fichiers bien définie et des tests automatisés.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence Portefeuille

Déclencheur

  • Mots-clés : Portefeuille, portefeuille, position, {PRIMARY_PROVIDER}, protocole, prêt, staking, liquidité

Quand NE PAS Utiliser

  • Requêtes de jetons générales (pas les positions de portefeuille)
  • Construction de transactions (utiliser le fournisseur correspondant)
  • Problèmes d'API non liés au portefeuille

Fichiers Principaux

TypeFichierObjectif
Contrôleursrc/entity/portfolio/portfolio.controller.tsAPI REST
Routeursrc/service/portfolio/source-router/*.service.tsOrchestration du routage
Clientsrc/service/portfolio/providers/{provider}/*.tsIntégration {PRIMARY_PROVIDER}
Agrégateursrc/service/portfolio/aggregation/*.service.tsCalcul d'agrégation
DTOsrc/dto/portfolio/position.types.tsModèle de position

Aperçu de l'API

Base : /onchain/v1/portfolio

Point de terminaisonMéthodeObjectif
/positionsPOSTObtenir les positions de portefeuille
/chainsGETListe des chaînes prises en charge
/protocolsGETListe des protocoles pris en charge

Résultat

  • Résultats de requête spécifiques au domaine avec références de code
  • Analyse et recommandations basées sur l'architecture actuelle

Vérification

  • Données de position correctement normalisées
  • Cache hit/miss fonctionne correctement
  • Calculs d'agrégation précis

Guide de Développement

Ajouter un Support de Protocole

  1. Vérifier si {PRIMARY_PROVIDER} le prend en charge
  2. Si une construction personnalisée est nécessaire : implémenter PortfolioPositionExtractor + enregistrer + configurer le routage

Ajouter une Source de Données

  1. Implémenter ProviderClient + Adapter
  2. Enregistrer avec SourceRouter
  3. Configurer la stratégie de routage

Déboguer

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

Références

  • references/architecture.md - Architecture système + stratégie de cache
  • references/api.md - Référence API + modèles de données
  • @docs/features/portfolio/ - Documentation détaillée

Tests

TypeEmplacement
Unitairetest/unit/service/portfolio/
Intégrationtest/integration/portfolio/

Exemples

Entrée : Comment interroger les positions de portefeuille ?
Action : Expliquer l'API POST /positions + la stratégie de routage
Entrée : Comment fonctionne l'intégration {PRIMARY_PROVIDER} ?
Action : Expliquer le flux {PRIMARY_PROVIDER}Client + {PRIMARY_PROVIDER}Adapter

Skills associés