# Weekly Investment

> 生成本地投资组合周报。先调 portfolio-check 做数据体检（刷新并扫描异常），再调 pse-review 用 PSE 三角色流水线生成深度周报（组合概览 / 收益点评 / 风险警示 / 调仓建议）。适合回答「帮我看看这周投资情况」「生成投资周报」。

- Skill: `erishen/weekly-investment` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add erishen/weekly-investment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/erishen/weekly-investment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: erishen (https://skillmd.com/u/erishen)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/erishen/weekly-investment

---


# 每周投资回顾（Weekly Investment）

## 适用场景

用户想要一份基于**本地真实持仓快照**的投资回顾/周报。数据来自 autogen-pse 的 portfolio-review 管线（asset-lens 计算 + money-csv 快照）。周报由 PSE 三角色流水线（pse-review）生成，质量高、可复用。

## 步骤

**执行原则：在调用 `pse-review` 并拿到最终周报（或确定失败、需要用户选择）之前，不要结束本轮回复。** 每一步都通过调用对应工具推进，不要只输出"即将生成/开始生成"之类的声明性文本就收尾——那会中断整个流程。体检通过后，下一步必须立刻调用 `pse-review` 工具，不能跳过。

0. **数据体检（必做前置）**：先调用 `portfolio-check` 工具（只读、无审批）。它会在 asset-lens 项目里依次跑 `make calculate / make analyze / make compare` 刷新本地快照，并扫描异常（如年化收益率为天文数字、产品级离群值、内置风险提示），返回体检结论。
   - 若返回 `error:` 或 ⚠️ 异常（尤其年化收益率出现 1e19% 这类失真值）：**先停下来**，把异常原样转述给用户，请其修复持仓数据（通常是某只产品投资天数过短导致年化被放大），**不要**继续后续 review。
   - 体检通过（加权年化 / 整体收益正常、无离群值）再进入下一步。

1. **生成深度周报**：调用 `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` 注册，否则本技能无法取到真实持仓数据。

2. **确认数据基准**：`pse-review` 产出的报告基于**快照日期**（如「投资数据截止 2026年08月22日」）。向用户展示时必须声明这个时间基准，**不得**把快照数据当作「当前实时行情」来分析。

3. **呈现周报**（Markdown，报告自带结构）：
   - **一句话结论**：组合整体状态（收益正负、主要风险级别）
   - **组合概览表**：总资产 / 总投入 / 已实现收益 / 未实现收益 / 收益率 / 年化
   - **收益点评**：从「增长引擎持仓明细」「黄金持仓明细」里挑涨跌幅突出的品种点评 2-3 条
   - **风险警示**：来自「自动检测问题」「风险分布」，每条标注数据截止日期
   - **调仓建议**：只针对摘要里反映的**结构性问题**（长期亏损、资金效率低、同类重复、C 类份额费率等），**不预测市场方向**
   - 末尾注明：「数据来源：本地快照（截止 {快照日期}），非实时行情」

4. **隐私红线**：报告含**真实持仓数据**（金额、品种、收益率）。周报只输出给当前用户，**不要**把原始摘要或具体金额外发、写入任何公开文件、或提交到版本库。

## 注意事项

- `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 或资产文件——本技能只读。