stock-portfolio-compare 是一款面向多组合多维对比分析的全新自设计工具，用户输入 2-5 个股票投资组合（每组合包含股票名称、代码、持股数、成本价、现价和行业分类），即可自动计算 12 维对比指标体系——涵盖收益率、夏普比率、最大回撤、加权 ROE、加权 PE、胜率、行业集中度、个股集中度、分散度、盈亏比、质量分和年化收益——并按类别自动标注各组合的优势维度（绿标）和劣势维度（橙标）。核心输出为交互式 HTML 对比看板，内嵌 Chart.js 六维能力雷达图（收益能力 / 风险控制 / 组合效率 / 结构优化 / 持仓质量 / 胜率表现）、12 维指标并排对比表（自动绿底最优、橙底最劣）、优劣分析卡片和个股贡献分解（Top3 贡献股 + Bottom 拖累股），同时支持 --snapshot 快照保存机制将当前组合状态序列化到本地 JSON 文件中，配合 --compare 实现历史时刻的跟踪复盘。纯 Python 3 单脚本实现，无需外部网络依赖，内置 2 组合 × 5 只股票的样例数据可直接运行验证。
--snapshot 保存快照，月末用 --compare 看各组合收益率、行业配置、权重变化的趋势| 模块 | 文件 | 功能 |
|---|---|---|
| 核心引擎 | scripts/compare_portfolios.py | 单脚本实现数据加载、指标计算、多组合对比、优劣识别、HTML 生成、快照保存 |
| 数据层 | data/portfolios.json | 组合定义 + 历史快照序列化存储 |
| 指标体系 | references/comparison-metrics.md | 12 维计算公式说明 + 雷达图归一化规则 |
| 入口文档 | SKILL.md | 全流程工作流、触发词、命令行参数、降级规则 |
| 测试项 | 结果 | 验证内容 |
|---|---|---|
| Python 编译 | 通过 | compare_portfolios.py 无语法错误 |
| 引擎函数（4 项） | 通过 | total_value=21000 / profit=1000 / win_rate=0.5 / weighted_roe=15.71 全部准确 |
| 多组合对比 + 雷达 + 优劣 | 通过 | 2 组合/6 维雷达/优劣卡片全部正确 |
| 编码完整性（5 文件） | 通过 | 0 处乱码 |
| 文本模式 | 通过 | 科技成长 +37.3% vs 稳健均衡 +7.5% 正确输出 |
| HTML 看板（10/10） | 通过 | Chart.js/雷达/对比表/优劣卡/个股贡献/免责声明全部存在 |
| 快照保存 + 历史追加 | 通过 | 2 组合各 1 条快照成功写入 JSON |
| 方向验证（5/5） | 通过 | 高收益高ROE=科技成长 / 高夏普低PE=稳健均衡，全部符合预期 |
压缩包：/Users/jintian/WorkBuddy/2026-07-31-09-50-05/stock-portfolio-compare-v1.0.0.zip · 安装：解压到 ~/.workbuddy/skills/