Communitygithub.com

ポートフォリオスキル

ポートフォリオシステムのナレッジベース。ポジション照会、ルーティング戦略、プロバイダー統合に関する質問に使用します。一般的なコード探索(code-exploreを使用)やコードレビュー(codex-code-reviewを使用)には使用しないでください。出力はドメイン固有の分析と推奨事項です。

ポートフォリオスキル とは?

このスキルは、ポートフォリオシステムのナレッジベースとして設計されており、ポジション照会、ルーティング戦略の質問、プロバイダー統合など、ポートフォリオ関連のドメイン固有のクエリを処理します。開発者がREST API(`/positions`、`/chains`、`/protocols`)を介してポートフォリオデータを取得・管理できるようにし、コントローラー、ルーター、プロバイダークライアント、アグリゲーターサービスを含む明確なアーキテクチャを提供します。このスキルは特に{AWS環境}での使用を想定しており、キャッシュ戦略や集約計算を活用して最新のポジション情報を提供します。ユーザーはこのスキルを使用して、ポジションデータの取得方法、プロトコルの追加方法、ルーティング構成のデバッグ方法を理解できます。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ポートフォリオスキル は何をしますか?

トリガー

  • キーワード: Portfolio, portfolio, ポジション, {PRIMARY_PROVIDER}, プロトコル, レンディング, ステーキング, 流動性

使用すべきでない場合

  • 一般的なトークンクエリ(ポートフォリオのポジションではない)
  • トランザクション構築(対応するプロバイダーを使用)
  • ポートフォリオに関連しない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 のフローを説明

関連スキル