为什么值得关注

它系统地从多个权威越南来源汇总数据，并在统一的标准仪表板中展示，同时强制执行数据质量规则并避免使用占位符。

适合谁使用

越南宏观经济学家和分析师
关注越南的外国投资者
东南亚经济学研究人员
报道越南的经济记者

典型使用场景

月度经济监测和报告
投资研究准备
学术宏观经济分析
政策与商业决策支持

项目优势

整合五个官方免费来源到单一工作流
四条数据质量规则确保一致性
金融科技风格交互式仪表板含五个标签
仅使用真实数据，无占位符

使用前须知

需要网络抓取能力（WebSearch, curl等）
仅支持月度频率数据，无季度或年度调整
不提供投资建议，也不包含主观分析

README 快速开始

📊 vn-macro-monthly — Báo cáo vĩ mô Việt Nam hàng tháng

Skill tạo báo cáo vĩ mô VN monthly toàn diện 41 chỉ số từ 5 nguồn chính thức (NSO + Customs + S&P PMI + VBMA + VNBA). Bao phủ 4 trụ cột: sản xuất + ngoại thương + tiền tệ + tài chính.

Cấu trúc skill

vn-macro-monthly/
├── SKILL.md                      # Workflow chính (pre-flight → fetch → extract → render)
├── README.md                     # File này
├── references/
│   ├── core_rules.md             # 4 rules: Time / Frequency / Conflict / Unit
│   ├── sources_overview.md       # 5 nguồn: URL pattern + cách fetch
│   ├── preflight_check.md        # Kiểm tra toàn vẹn + lịch release + user override
│   ├── data_cards.md             # Schema data card + 41 chỉ số + narrative rule
│   ├── rendering.md              # HTML design pattern + 5 tab + placement rule
│   ├── news_sources.md           # Nguồn báo chí enrich (3 nhóm)
│   └── images.md                 # Ảnh minh họa stock (Unsplash)
├── assets/
│   └── report_template.html      # Template HTML dashboard (Chart.js + CSS fintech)
├── scripts/
│   └── qa_report.js              # Automated QA (Playwright)
└── agents/
    └── openai.yaml               # OpenAI agent interface

Workflow 4 bước

Pre-flight — kiểm tra 5 nguồn có sẵn chưa (all-or-nothing, hoặc user override partial)
Fetch + cache — tải 5 nguồn về sources_cache/
Extract — parse → 41 data cards + apply 4 rules + narrative
Render — HTML dashboard 5 tab (Kinh tế thực / Tiền tệ / Ngành / Bối cảnh / Tổng hợp)

Đặc trưng

5 nguồn chính thức miễn phí: NSO, Tổng cục Hải quan, S&P Global PMI, VBMA, VNBA
4 rules chất lượng: Time Consistency, Frequency (monthly-only), Conflict Resolution, Unit Convention
Dashboard đồng style: fintech dark theme, 5 tab nav, click-to-chart (ngủ chờ <6 tháng data)
Nguyên tắc không placeholder: chỉ tạo card khi có data thật
Narrative "người kể chuyện số liệu": KHÔNG cho ý kiến, chỉ kể diễn biến số

Sử dụng

Skill này hoạt động trong môi trường có thể fetch web (WebSearch, WebReader, curl, pdftotext). Kích hoạt:

/vn-macro-monthly 2026-06

Changelog

Xem cuối SKILL.md cho lịch sử thay đổi (bỏ cross-check, thêm nguyên tắc không placeholder, 5 tab, etc.).

License

Miễn phí cho mục đích cá nhân và nghiên cứu. KHÔNG phải lời khuyên đầu tư.

vimovietnam