portfolio-report

核心用法

portfolio-report 是一个协调型分析技能，专为 Uniswap 流动性提供者设计。它并非直接执行复杂计算或链上查询，而是作为智能编排层，将用户的自然语言请求（如"查看我的头寸"、"分析 PnL"）转化为结构化任务，委托给专业的 portfolio-analyst agent 处理。用户可通过可选参数定制分析范围：指定钱包地址（默认使用配置的钱包）、筛选特定区块链网络（如 Ethereum、Polygon 等）或聚焦特定分析维度（positions/pnl/fees/full）。该技能生成标准化的投资组合报告，包含总持仓价值分解（LP 头寸、闲置代币、未领取费用）、盈亏分析（已实现/未实现损益扣除 Gas 成本）、无常损失评估（绝对值与百分比），以及关键的可操作建议（如领取费用、再平衡提醒）。

显著优点

该技能的最大优势在于其纯文档型架构，SKILL.md 中不包含任何可执行代码块，彻底消除了代码注入、动态加载等执行层风险，安全评级达到 A 级。其次，其跨链整合能力允许用户一键获取分散在多条 EVM 链上的 Uniswap V3 头寸全景视图，解决了多链 DeFi 管理的碎片化痛点。第三，财务指标的专业性体现在对 Gas 成本的精确扣除（避免虚增收益）和无常损失的双维度展示，更适合严谨的税务申报和投资复盘。此外，输出格式兼顾机器可读性与人类可读性，通过"IN RANGE/OUT OF RANGE"等状态标签快速识别需要干预的头寸。

潜在缺点与局限性

作为纯委托型技能，其功能完全依赖外部 agent，若 portfolio-analyst 服务不可用或返回错误数据，该技能将失效，存在单点故障风险。数据层面，报告明确提示存在 RPC/Subgraph 同步延迟，不适合需要实时价格的套利或紧急清算决策。来源方面，该技能托管于个人开发者账号（T3 来源），相比官方或知名组织维护的项目，长期更新维护的稳定性存疑。功能边界上，它仅提供分析不产生交易，用户需手动执行再平衡或领取费用操作。

适合的目标群体

本技能最适合跨链 Uniswap V3 流动性提供者和DeFi 投资组合经理，特别是持有 3 个以上头寸或横跨 2 条以上链的用户。对于需要进行税务申报的投资者，其详细的 PnL 和 Gas 成本记录具有重要参考价值。此外，被动 LP 策略执行者可通过"Out of Range"提醒及时再平衡，避免资本效率低下。不适合高频交易者或需要实时执行的交易机器人开发者。

使用风险与注意事项

尽管 skill 本身无代码风险，但需注意：数据准确性完全依赖底层 RPC 节点和 Subgraph 的索引质量，极端行情下可能出现价格偏差。无常损失计算基于特定数学模型，可能与用户自定义的计算方式存在差异。权限方面，虽然 skill 不直接请求私钥，但依赖的 agent 可能需要钱包配置，建议使用专用只读钱包或硬件钱包配置，避免暴露高权限私钥。最后，Gas 成本估算可能因网络拥堵状况与实际支出存在偏差，不应作为精确的成本核算依据。