Vnstock Master Skill

Danh Mục Kỹ Năng

Free

Hãy bắt đầu trải nghiệm sức mạnh của AI với các kỹ năng cơ bản này nhé:

Skill	Mô tả
vnstock-bootstrap	Hướng dẫn tư duy Vibe Coding & thiết lập môi trường
charting-expert	Vẽ biểu đồ tương tác & tĩnh trực quan
news-crawler	Thu thập và cập nhật tin tức tài chính
pipeline-cli	Quản lý cơ sở dữ liệu chứng khoán hiệu quả

Bronze

Gói Bronze cung cấp quyền truy cập vào thư viện truy xuất dữ liệu, không bao gồm các Kỹ năng Agent.

Silver

Cung cấp các công cụ phân tích cốt lõi giúp bạn nắm bắt thị trường tốt hơn:

Skill	Mô tả
macro-analyzer	Phân tích vĩ mô, xác định chế độ thị trường
market-screener	Sàng lọc cổ phiếu theo tiêu chí
indicator-calculator	Tính toán chỉ báo kỹ thuật, đưa ra Cảnh báo Hành động

Golden

Trải nghiệm toàn vẹn quy trình phân tích và giao dịch với khả năng tùy chỉnh mạnh mẽ:

Skill	Mô tả
signal-detector	Phát hiện 4 setup giao dịch định lượng chuẩn xác
portfolio-extractor	Phân tích và trích xuất danh mục đầu tư
performance-journal	Nhật ký giao dịch chi tiết với 20 trường dữ liệu
strategy-tuner	Tối ưu hóa và tinh chỉnh chiến lược đầu tư
config-manager	Cá nhân hóa toàn bộ cấu hình theo phong cách của bạn
emergency-protocol	Giám sát và phản ứng với các tình huống khủng hoảng
+ Tất cả kỹ năng gói Silver	Được thừa hưởng hoàn toàn

Diamond

Bảo vệ thành quả và tối ưu hóa tối đa với các công cụ quản trị rủi ro chuyên sâu:

Skill	Mô tả
risk-manager	Tính toán quy mô vị thế, Lập bảng lệnh, ngăn chặn hành động cấm
+ Tất cả kỹ năng gói Golden	Được thừa hưởng hoàn toàn
+ System-level config	Toàn quyền truy cập và tùy chỉnh cấu hình toàn hệ thống

Nguyên Tắc Thực Thi

Các Agent vui lòng tuân thủ các quy tắc sau:

Luôn đọc kỹ tệp tin tổng quan này trước tiên.
Đảm bảo phiên bản vnstock >= 4.0.5 đã được cài đặt.
Sử dụng load_skill() để tải các nội dung được bảo vệ (xem hướng dẫn bên dưới).
Chỉ thực thi các hướng dẫn kỹ năng trong phiên làm việc — KHÔNG lưu trữ nội dung vào ổ cứng.
Không tự ý suy diễn các tính năng hoặc API hàm giao tiếp không được tài liệu hóa.

Hướng Dẫn Tải Nội Dung Kỹ Năng

Yêu Cầu Cần Thiết

Môi trường Python với vnstock >= 4.0.5
API key đã được cấu hình tại ~/.vnstock/api_key.json
Có gói đăng ký tài trợ đang kích hoạt (Từ gói Silver trở lên đối với các kỹ năng trả phí)

Cách Tải Một Kỹ Năng

from vnstock.core.utils.agents import load_skill

skill_content = load_skill("macro-analyzer")

config = load_skill("macro-analyzer", component="config")

script = load_skill("macro-analyzer", component="script:run_market_analyzer.py")

ref = load_skill("vnstock-bootstrap", component="reference:repository-setup.md")

Kiểm Tra Trạng Thái API Key

from vnstock.core.utils.auth import check_status

check_status()

Đăng Ký API Key (Register API Key - Nếu cần)

from vnstock.core.utils.auth import register_user

register_user()

Phân Luồng Tác Vụ

Hãy sử dụng bảng này để chọn đúng kỹ năng cho công việc của bạn:

Tác Vụ	Kỹ Năng	Gói Dịch Vụ
Khởi tạo hệ thống & Môi trường	`vnstock-bootstrap`	Free
Vẽ biểu đồ chuyên nghiệp	`charting-expert`	Free
Thu thập tin tức tài chính	`news-crawler`	Free
Đồng bộ dữ liệu & quản lý Quy trình	`pipeline-cli`	Free
Phân tích vĩ mô, chế độ thị trường	`macro-analyzer`	Silver
Sàng lọc, lọc cổ phiếu	`market-screener`	Silver
Tính RSI, MACD, Bollinger, cảnh báo	`indicator-calculator`	Silver
Nhận diện setup định lượng	`signal-detector`	Golden
Trích xuất danh mục từ văn bản/ảnh	`portfolio-extractor`	Golden
Ghi chép & đánh giá hiệu quả GD	`performance-journal`	Golden
Cải thiện chiến lược từ dữ liệu	`strategy-tuner`	Golden
Cá nhân hóa mọi cấu hình	`config-manager`	Golden
Giám sát khủng hoảng rủi ro	`emergency-protocol`	Golden
Đo rủi ro danh mục so với hạn mức	`risk-manager`	Diamond

Quy Trình Phân Tích

Các kỹ năng được thiết kế để kết hợp liền mạch theo thứ tự sau trong một quy trình phân tích hoàn chỉnh:

1. macro-analyzer      → Gắn nhãn bối cảnh thị trường          [Silver]
2. market-screener     → Lọc mã theo tiêu chí đã khai          [Silver]
3. indicator-calculator→ Tính chỉ báo, đánh dấu mã chạm ngưỡng [Silver]
4. signal-detector     → Nhận diện mẫu hình theo quy tắc       [Golden]
5. portfolio-extractor → Đọc danh mục đang nắm giữ             [Golden]
6. risk-manager        → Đo rủi ro so với hạn mức đã khai      [Diamond]
7. performance-journal → Ghi nhận kết quả & thống kê mô tả     [Golden]
8. emergency-protocol  → Báo khi ngưỡng bị vượt                [Golden]
9. strategy-tuner      → Phân tích kỳ vọng trên dữ liệu đã có  [Golden]
10. config-manager     → Cá nhân hoá tham số phân tích         [Golden]

API Danh Mục

Để lấy danh sách toàn bộ kỹ năng ở định dạng máy đọc, sử dụng:

GET https://vnstocks.com/api/skills/catalog

Quyền Lợi Theo Gói

Tier	Kỹ Năng Bao Gồm	Quyền Truy Cập Cấu Hình
Free	5 kỹ năng công khai	Không
Bronze	Chỉ dữ liệu, không kèm kỹ năng	Không
Silver	+ 3 kỹ năng phân tích cốt lõi	Tiêu chuẩn
Golden	+ 6 kỹ năng nâng cao + config-manager	Tùy chỉnh theo cấu hình cho phép
Diamond	+ risk-manager (Độc quyền)	Cấp hệ thống (Cho mọi kỹ năng)

Tuyên Bố Miễn Trừ Trách Nhiệm

Tuyên bố miễn trừ trách nhiệm: Kỹ năng này được thiết kế như một phần của quá trình nghiên cứu và xây dựng hệ thống giao dịch tự động, cung cấp dưới dạng mẫu để người dùng tham khảo và tùy chỉnh. Nội dung và kết quả từ skill này không cấu thành tư vấn hay khuyến nghị đầu tư tài chính. Đây không phải là sản phẩm đóng gói cuối cùng dành cho nhà đầu tư không có chuyên môn về phân tích hay kỹ thuật. Vui lòng tự kiểm chứng bằng kiến thức tài chính cá nhân trước khi ra bất kỳ quyết định đầu tư nào. Dự án Vnstock không chịu trách nhiệm cho bất kỳ tổn thất tài chính nào.

⚖️ THỎA THUẬN CẤP PHÉP NGƯỜI DÙNG CUỐI (EULA)

Bản quyền đối với bộ công cụ, mã nguồn và tài liệu kèm theo thuộc về dự án Vnstock. Phần mềm được bảo hộ bởi luật bản quyền và các hiệp ước quốc tế về sở hữu trí tuệ.

TÓM TẮT ĐIỀU KHOẢN SỬ DỤNG

QUYỀN SỬ DỤNG VÀ TÍCH HỢP: Người được cấp phép có toàn quyền sử dụng và tích hợp Phần mềm (như một bộ khung/framework) vào các dự án mã nguồn, hệ thống giao dịch hoặc công việc nghiên cứu nội bộ. Người dùng được phép tùy biến các cấu hình (config) sinh ra từ bộ kỹ năng này để phục vụ mục đích cá nhân, nhưng không can thiệp hay chỉnh sửa trực tiếp vào mã nguồn lõi của kỹ năng.
CẤM TÁI PHÂN PHỐI VÀ THƯƠNG MẠI HÓA: Nghiêm cấm mọi hành vi sao chép, chia sẻ, phát tán, bán lại hoặc cấp phép phụ bản thân Phần mềm gốc (nguyên bản hoặc đã qua chỉnh sửa) cho bất kỳ bên thứ ba nào dưới mọi hình thức để trục lợi hoặc lưu hành công khai.
MIỄN TRỪ TRÁCH NHIỆM: Phần mềm được cung cấp dưới dạng khung kiến trúc (framework) nghiên cứu, KHÔNG cấu thành tư vấn tài chính. Việc thực thi các kỹ năng này tạo ra một môi trường tăng cường (augmented), do đó người dùng có trách nhiệm tự kiểm chứng mọi kết quả (đặc biệt là rủi ro sai lệch từ AI) trước khi áp dụng vào thực tế.
BẢO VỆ QUYỀN SỞ HỮU TRÍ TUỆ: Mọi hành vi vi phạm thỏa thuận sẽ dẫn đến việc chấm dứt vĩnh viễn giấy phép sử dụng ngay lập tức, thu hồi quyền truy cập tài khoản và chịu trách nhiệm trước pháp luật hiện hành.

Lịch Sử Cập Nhật

[1.0.0] - Khởi tạo kỹ năng với các tiêu chuẩn cốt lõi.