持仓每周跟踪(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)|本包为独立发布物,不依赖其他任何技能包
微信扫一扫