Communitygithub.com

sd0xdev/sd0x-harness

投資組合系統知識庫。用於:持倉查詢、路由策略問題、提供商整合。不用於:一般程式碼探索(使用 code-explore)、程式碼審查(使用 codex-code-review)。輸出:領域特定分析與建議。

sd0x-harness 是什麼?

此技能作為一個專門的知識庫,用於管理與投資組合系統相關的查詢,例如持倉查詢、路由策略問題及提供商整合。它專注於領域特定的分析,並提供基於當前架構的建議及程式碼參考。此技能支援 RESTful API 端點(例如 `/positions`、`/chains`、`/protocols`),並透過控制器、路由器、用戶端和聚合器等核心元件來組織與處理資料。此技能明確不適用於一般的程式碼探索或程式碼審查,以確保使用者能獲得精確且相關的協助。開發人員可以參考核心檔案清單來快速定位程式碼,並利用提供的開發指南來新增協議支援或資料來源。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Portfolio 技能

觸發

  • 關鍵字:Portfolio, portfolio, position, {PRIMARY_PROVIDER}, protocol, lending, staking, liquidity

何時不使用

  • 一般代幣查詢(非 Portfolio 持倉)
  • 交易構建(請使用對應的提供者)
  • 與投資組合無關的 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 流程

相關技能