每周投资回顾(Weekly Investment)
适用场景
用户想要一份基于本地真实持仓快照的投资回顾/周报。数据来自 autogen-pse 的 portfolio-review 管线(asset-lens 计算 + money-csv 快照)。周报由 PSE 三角色流水线(pse-review)生成,质量高、可复用。
步骤
执行原则:在调用 pse-review 并拿到最终周报(或确定失败、需要用户选择)之前,不要结束本轮回复。 每一步都通过调用对应工具推进,不要只输出"即将生成/开始生成"之类的声明性文本就收尾——那会中断整个流程。体检通过后,下一步必须立刻调用 pse-review 工具,不能跳过。
数据体检(必做前置):先调用
portfolio-check工具(只读、无审批)。它会在 asset-lens 项目里依次跑make calculate / make analyze / make compare刷新本地快照,并扫描异常(如年化收益率为天文数字、产品级离群值、内置风险提示),返回体检结论。- 若返回
error:或 ⚠️ 异常(尤其年化收益率出现 1e19% 这类失真值):先停下来,把异常原样转述给用户,请其修复持仓数据(通常是某只产品投资天数过短导致年化被放大),不要继续后续 review。 - 体检通过(加权年化 / 整体收益正常、无离群值)再进入下一步。
- 若返回
生成深度周报:调用
pse-review工具(见${SKILL_DIR}/scripts/)。它会重算快照并运行 Planner/Specialist/Evaluator 三角色团队 + 个人知识库检索,产出完整周报 Markdown(含组合概览 / 自动检测问题 / 黄金与房产快照 / 汇率 / 资产配置 / 持仓明细 / 风险分布 / 市场行情 / 投资效率 / 收益点评 / 调仓建议)。耗时 2-6 分钟。- 若返回
error:开头(如免费默认模型偶发抽风PSE_RETRY_CHOICE):不要编造报告内容,把失败原因原样转述给用户,并给出选项——重试免费默认模型(OpenAI 兼容网关)或改用 deepseek(付费,会触发审批)。 - 报告文件会落到
sandbox/weekly-investment/<模型>__weekly_review_<日期>.md,可让用户预览。
- 若返回
工具来源:
portfolio-check与pse-review是本技能自带的 MCP 桥(见${SKILL_DIR}/scripts/, 零依赖 Node stdio server,桥接 autogen-pse / asset-lens 数据管线)。你的 harness 若没注册这两个工具 (resolve-tui 在 config.toml[mcp_servers]、Claude Code 在.mcp.json),先照${SKILL_DIR}/scripts/README.md注册,否则本技能无法取到真实持仓数据。
确认数据基准:
pse-review产出的报告基于快照日期(如「投资数据截止 2026年08月22日」)。向用户展示时必须声明这个时间基准,不得把快照数据当作「当前实时行情」来分析。呈现周报(Markdown,报告自带结构):
- 一句话结论:组合整体状态(收益正负、主要风险级别)
- 组合概览表:总资产 / 总投入 / 已实现收益 / 未实现收益 / 收益率 / 年化
- 收益点评:从「增长引擎持仓明细」「黄金持仓明细」里挑涨跌幅突出的品种点评 2-3 条
- 风险警示:来自「自动检测问题」「风险分布」,每条标注数据截止日期
- 调仓建议:只针对摘要里反映的结构性问题(长期亏损、资金效率低、同类重复、C 类份额费率等),不预测市场方向
- 末尾注明:「数据来源:本地快照(截止 {快照日期}),非实时行情」
隐私红线:报告含真实持仓数据(金额、品种、收益率)。周报只输出给当前用户,不要把原始摘要或具体金额外发、写入任何公开文件、或提交到版本库。
注意事项
portfolio-check会跑完整的make calculate / analyze / compare(刷新 + 扫描),首次运行可能耗时 1-3 分钟,属正常;它已能独立兜底数据异常(年化 > 10000% 即判失真),但资产护栏(asset-lens内的 ANNUAL_RETURN_PLAUSIBLE_CAP)才是根本修复。pse-review会重算资产收益并跑完整 PSE 三角色(Planner/Specialist/Evaluator + 个人知识库检索),耗时 2-6 分钟,属正常。- 模型由
pse-review的provider参数决定(默认=免费默认模型,OpenAI 兼容网关、非流式;传deepseek=付费流式质量更高)。 - 免费默认模型免费、非流式,但偶发抽风(返回
PSE_RETRY_CHOICE);deepseek 走 autogen-pse/.env 的 key,会产生费用。务必在周报里告知用户本次用的是哪个模型。
- 模型由
- 若工具返回
error:前缀:说明收益计算管线失败(多为数据快照过期或缺依赖),原样转述错误,不要编造数据。 - 不要修改/生成任何持仓 CSV 或资产文件——本技能只读。