持仓每周跟踪（portfolio-weekly-tracker）v1.1.2

这是什么

一款面向个人投资者的 AI 助手技能包：对你的自选持仓组合做周度跟踪，每周一句话生成结构化 HTML 周报——行情快照、近 7 天企业层+行业层信息扫描、投资假设反证体检、多空排序、校准账与关键节点日历。

你的持仓你定义：持仓清单与投资假设账本在 config/holdings.json 中自行配置（A股/港股/美股/B股/ETF 均可），不预设任何默认持仓。

核心机制——假设反证账本：为每只持仓写下"可证伪的投资假设"+ 反证阈值（如"直销占比提升支撑双位数营收增长，营收同比 <+10% 即击穿"），每周扫描：

🟢 健康 / ✅ 强确认（正面验证）/ 🔍 领先预警（接近阈值）/ ⚠️ 触发（击穿，需复盘）/ ✖ 失效（阈值需修订）

解决什么问题：

买了就不管，利空出来才发现 → 每周固定扫描公告/财报/行业事件，交付前 24 小时尾部复扫
持有逻辑漂移而不自知 → 假设账本把"买入理由"变成"可检验的命题"，击穿即报警
周报写成流水账 → 十章固定结构：核心结论先行 → 假设总览 → 行情 → 逐家多空 → 多空排序 → 校准账 → 节点日历 → 时点完整性声明（缺口显式化不掩盖）
看不到组合全貌 → 多空排序单表总览全部持仓四档梯队

所需环境

| 依赖 | 必需性 | 说明 | |------|--------|------| | AI 助手（任意） | 必需 | WorkBuddy、CodeBuddy、Claude、ChatGPT 等任一大模型对话环境均可 | | 持仓配置文件 | 必需 | config/holdings.json（复制模板填写，一次性工作） | | HTTP 数据接口 | 可选 | 不配置也能用（提示后改走公开渠道/用户提供数据，缺项标"待补查"）；配置后自动拉行情/新闻/公告 | | Python 3.8+ | 可选 | 仅当自行编写接口适配脚本时 |

无任何强制安装、无代码依赖。

运行方式

方式一：安装为 AI 助手技能（推荐）

WorkBuddy：将本文件夹放入 ~/.workbuddy/skills/，或通过 skillhub 安装
其他兼容 SKILL.md 约定的 AI 助手：放入其 skills 目录

安装后直接说：

生成本周持仓周报

方式二：直接作为提示词 把 SKILL.md 全文粘贴进任意大模型对话 + 提供 holdings.json 内容与本周数据即可。

方式三：人工使用 SKILL.md 的五步扫描流程 + 周报十章结构 + templates/weekly-report-template.html 可作为每周复盘的手工骨架。

快速开始（3 步）

解压本文件夹；复制 config/holdings.example.json → config/holdings.json，把示例标的替换成你的持仓，为每只写下投资假设与反证阈值
（可选）复制 config/config.example.json → config/config.json 配置数据接口 + 设置环境变量 PORTFOLIO_TRACKER_API_KEY
每周对 AI 助手说一句"生成持仓周报"

目录结构

portfolio-weekly-tracker/
├── README.md                       # 本文件
├── icon.svg / icon.png             # 技能图标（512×512 · 红色渐变 · 方形圆角）
├── SKILL.md                        # 技能主文档（五步扫描流程 + 假设账本机制 + 配置）
├── requirements.txt                # 依赖清单（零硬依赖，仅说明）
├── config/
│   ├── config.example.json         # 全局配置模板（数据接口/输出/配色）
│   └── holdings.example.json       # 持仓清单 + 假设账本模板（用户必填）
├── templates/
│   └── weekly-report-template.html # 周报十章 HTML 模板（含占位符）
└── examples/
    └── example-usage.md            # 6 个使用示例（首次配置/常规周报/财报季/多币种/衍生品/接口失败）

首次使用：数据源建议

本 skill 不强制绑定任何数据源（通用版本），请在 config/config.json 绑定适合你的数据源组合。推荐：

| 推荐度 | 数据源 | 说明 | |--------|--------|------| | 首推 | Wind API（AIFin Market） | 有免费额度；自行下载注册后配置 | | 其次 | WorkBuddy 内置通达信 MCP | WorkBuddy 环境自带 | | 备选 | 东方财富妙想（MX）/ 同花顺 skill 等 | 按需绑定 |

建议配置两个以上数据源做交叉验证。不配置也能用（手工数据模式）。

配置说明

持仓配置（必填）：config/holdings.json —— 每只标的的 name / code / market / currency / tags / assumptions（假设账本）；watch_only: true 的标的进入"或有持仓监控"章节（如卖 put 敞口）；多股份类别（A/B/H）用 valuation_note 指定估值锚以实际持有类别计价。

数据接口（可选）：复制 config.example.json → config.json，填 base_url 与 endpoints；密钥通过环境变量 PORTFOLIO_TRACKER_API_KEY 注入，禁止明文写入任何文件。配色默认 A股惯例（涨红跌绿），可切国际惯例。

接口未配置/未授权/不可访问时明确提示并降级（公开渠道+用户数据），行情缺项标"待补查"，禁止用旧值或估算值填充。

常见问题

Q：假设触发是不是就该卖？ 不是。触发 = 买入逻辑被击穿、需复盘"短期承压还是逻辑破灭"；处置决策始终在你。周报只做体检，不做指令。

Q：没有 API，行情数据从哪来？ 公开渠道检索（交易所/公司公告/正规财经媒体）+ 你粘贴的数据；缺项诚实标"待补查"。

Q：和其他三个技能包的关系？ 完全独立，无任何依赖。可单独下载使用；与其他技能包同时安装互不冲突。

免责声明

本周报仅为持仓信息跟踪与假设体检，不构成任何投资建议；持仓与假设是你的本地配置，不会上传或共享。

版本：v1.1.2（2026-08-28）｜本包为独立发布物，不依赖其他任何技能包