Communitygithub.com

Portafolio Skill (sd0xdev/sd0x-harness)

Base de conocimiento del sistema de portafolio. Úsalo para consultas de posición, preguntas sobre estrategia de enrutamiento o integración de proveedores. No lo uses para exploración general de código (usa code-explore) ni revisiones de código (usa codex-code-review). Salida: análisis específico del dominio + recomendaciones.

¿Qué es sd0x-harness)?

Este skill proporciona una base de conocimiento especializada para el sistema de portafolio, diseñado para ayudar a agentes de IA a responder consultas sobre posiciones en protocolos de lending, staking y liquidez. Su función principal es guiar al usuario a través de la arquitectura del módulo de portafolio, incluyendo controladores REST, enrutamiento de fuentes de datos, integración con proveedores primarios (como {PRIMARY_PROVIDER}), agregación de datos y modelos de posición. Está implementado para plataformas como Claude Code, Cursor o Codex, y se activa mediante palabras clave como 'portfolio', 'position' o nombres de protocolos. El skill organiza la información en archivos core (controlador, router, cliente, agregador y DTO) y proporciona una API REST con endpoints como `/positions`, `/chains` y `/protocolos`. Además, incluye una guía de desarrollo para agregar soporte a nuevos protocolos o fuentes de datos, comandos de depuración con Redis y curl, referencias a documentación detallada y ejemplos de interacción. Su uso está restringido a consultas específicas del dominio del portafolio; no debe utilizarse para exploración general de código o revisiones de código.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Skill de Portafolio

Activación

  • Palabras clave: Portfolio, portafolio, posición, {PRIMARY_PROVIDER}, protocolo, lending, staking, liquidez

Cuándo NO Usarlo

  • Consultas generales de tokens (no posiciones del portafolio)
  • Construcción de transacciones (usa el proveedor correspondiente)
  • Problemas de API no relacionados con portafolio

Archivos Principales

TipoArchivoPropósito
Controladorsrc/entity/portfolio/portfolio.controller.tsAPI REST
Enrutadorsrc/service/portfolio/source-router/*.service.tsOrquestación de enrutamiento
Clientesrc/service/portfolio/providers/{provider}/*.tsIntegración con {PRIMARY_PROVIDER}
Agregadorsrc/service/portfolio/aggregation/*.service.tsCálculo de agregación
DTOsrc/dto/portfolio/position.types.tsModelo de posición

Resumen de API

Base: /onchain/v1/portfolio

EndpointMétodoPropósito
/positionsPOSTObtener posiciones del portafolio
/chainsGETLista de cadenas compatibles
/protocolsGETLista de protocolos compatibles

Salida

  • Resultados de consultas específicas del dominio con referencias a código
  • Análisis y recomendaciones basados en la arquitectura actual

Verificación

  • Datos de posición normalizados correctamente
  • Aciertos/fallos de caché funcionando correctamente
  • Cálculos de agregación precisos

Guía de Desarrollo

Agregar Soporte para un Protocolo

  1. Verificar si {PRIMARY_PROVIDER} lo soporta
  2. Si se necesita una construcción personalizada: implementar PortfolioPositionExtractor + registrar + configurar enrutamiento

Agregar una Fuente de Datos

  1. Implementar ProviderClient + Adapter
  2. Registrar con SourceRouter
  3. Configurar estrategia de enrutamiento

Depuración

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

Referencias

  • references/architecture.md - Arquitectura del sistema + estrategia de caché
  • references/api.md - Referencia de API + modelos de datos
  • @docs/features/portfolio/ - Documentación detallada

Pruebas

TipoUbicación
Unitariastest/unit/service/portfolio/
Integracióntest/integration/portfolio/

Ejemplos

Entrada: ¿Cómo consultar las posiciones del portafolio?
Acción: Explicar la API POST /positions + estrategia de enrutamiento
Entrada: ¿Cómo funciona la integración con {PRIMARY_PROVIDER}?
Acción: Explicar el flujo de {PRIMARY_PROVIDER}Client + {PRIMARY_PROVIDER}Adapter

Skills relacionados