Communitygithub.com

sd0xdev/sd0x-harness

Base de conhecimento do sistema de portfólio. Use para: consultas de posição, perguntas sobre estratégia de roteamento, integração com provedores. Não use para: exploração geral de código (use code-explore), revisão de código (use codex-code-review). Saída: análise específica de domínio + recomendações.

O que é sd0x-harness?

Este skill fornece uma base de conhecimento especializada para consultas e análises relacionadas a portfólios em sistemas DeFi. Ele permite que um agente de IA recupere posições de portfólio, entenda estratégias de roteamento entre provedores (como {PRIMARY_PROVIDER}) e interaja com a lógica de agregação. O skill é útil para desenvolvedores que precisam responder perguntas sobre integração de provedores, fluxos de dados de posições e arquitetura do sistema, mas não deve ser usado para exploração genérica de código ou revisões. Ele é projetado para plataformas como Claude Code e Cursor, expondo endpoints REST, modelos de dados e arquivos de referência que guiam o agente na solução de problemas específicos de portfólio.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Skill de Portfólio

Gatilho

  • Palavras-chave: Portfólio, portfólio, posição, {PRIMARY_PROVIDER}, protocolo, empréstimo, staking, liquidez

Quando NÃO Usar

  • Consultas gerais de tokens (não posições de portfólio)
  • Construção de transações (use o provedor correspondente)
  • Problemas de API não relacionados ao portfólio

Arquivos Principais

TipoArquivoPropósito
Controladorsrc/entity/portfolio/portfolio.controller.tsAPI REST
Roteadorsrc/service/portfolio/source-router/*.service.tsOrquestração de roteamento
Clientesrc/service/portfolio/providers/{provider}/*.tsIntegração {PRIMARY_PROVIDER}
Agregadorsrc/service/portfolio/aggregation/*.service.tsCálculo de agregação
DTOsrc/dto/portfolio/position.types.tsModelo de posição

Visão Geral da API

Base: /onchain/v1/portfolio

EndpointMétodoPropósito
/positionsPOSTObter posições de portfólio
/chainsGETLista de cadeias suportadas
/protocolsGETLista de protocolos suportados

Saída

  • Resultados de consultas específicas de domínio com referências de código
  • Análise e recomendações com base na arquitetura atual

Verificação

  • Dados de posição normalizados corretamente
  • Acerto/erro de cache funcionando adequadamente
  • Cálculos de agregação precisos

Guia de Desenvolvimento

Adicionar Suporte a Protocolo

  1. Verifique se {PRIMARY_PROVIDER} oferece suporte
  2. Se for necessário uma construção personalizada: implemente PortfolioPositionExtractor + registre + configure roteamento

Adicionar Fonte de Dados

  1. Implemente ProviderClient + Adapter
  2. Registre com SourceRouter
  3. Configure a estratégia de roteamento

Depuração

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

Referências

  • references/architecture.md - Arquitetura do sistema + estratégia de cache
  • references/api.md - Referência da API + modelos de dados
  • @docs/features/portfolio/ - Documentação detalhada

Testes

TipoLocalização
Unitáriotest/unit/service/portfolio/
Integraçãotest/integration/portfolio/

Exemplos

Entrada: Como consultar posições de portfólio?
Ação: Explicar API POST /positions + estratégia de roteamento
Entrada: Como funciona a integração {PRIMARY_PROVIDER}?
Ação: Explicar fluxo do {PRIMARY_PROVIDER}Client + {PRIMARY_PROVIDER}Adapter

Habilidades Relacionadas