Communitygithub.com

sd0xdev/sd0x-harness

投资组合系统知识库。用于:持仓查询、路由策略问题、提供商集成。不用于:通用代码探索(使用 code-explore)、代码审查(使用 codex-code-review)。输出:领域特定分析 + 建议。

sd0x-harness 是什么?

该技能提供了一个全面的投资组合系统知识库,专门用于处理持仓查询、路由策略问题和提供商集成。它支持平台如 Claude Code、Cursor 和 Codex,并基于 SKILL.md 文档中的结构化指南运行。核心功能包括 REST API 端点管理(如 /positions、/chains、/protocols)、提供商集成流程(实施 PortfolioPositionExtractor 并注册路由)以及调试工具(如 redis-cli 和 curl 命令)。输出结果提供领域特定的分析、代码引用和架构优化建议。该技能适用于需要高效查询和管理投资组合持仓、处理缓存命中/未命中场景及聚合计算的开发者。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

投资组合技能

触发条件

  • 关键词:投资组合, portfolio, 持仓, position, {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 流程

相关技能