Full-code · bước 1 / 2 · chỉ dẫn tác nhân
Cho tác nhân lập trình đọc đúng cú pháp vnstock
Một lời nhắc để tác nhân cài thư viện vào ~/.venv và ghi khối chỉ dẫn vào AGENTS.md của dự án. Từ đó phiên nào cũng dùng đúng hàm, đúng tham số.
Tác nhân lập trình · du-an-cua-ban/
Bạn
Hãy giúp tôi thiết lập vnstock thế hệ 5 trên máy macOS, tuân thủ tài liệu tại vnstocks.com/files/vibe-onboarding.md …
Tác nhân · kế hoạch
- 1 Kiểm tra Python 3.10+
- 2 Cài vnstock vào ~/.venv
- 3 Chạy vnstock onboard, đọc quy tắc
- 4 Ghi khối vnstock vào AGENTS.md
- 5 Chạy một truy vấn mẫu chỉ đọc
Bạn đã duyệt kế hoạch · tác nhân đang chạy
$ ~/.venv/bin/vnstock onboard
✓ Đã ghi khối vnstock vào AGENTS.md
✓ Truy vấn mẫu chạy được
01 · Thiết lập
Ba bước, một lời nhắc
Làm một lần cho mỗi máy. Dự án mới chỉ cần ghi lại khối chỉ dẫn vào AGENTS.md.
01
Mở trợ lý AI bạn đang dùng
Trên máy tính, bản ứng dụng hay trợ lý dòng lệnh đều được.
Ứng dụng trò chuyện
- Claude
- ChatGPT
- Antigravity
Chạy lệnh trên máy
- Claude Code
- Codex
- VS Code
- Antigravity IDE
Các trợ lý lập trình chuyên dụng (như Claude Code, Antigravity) có thể tự động cài đặt thay bạn. Với ứng dụng trò chuyện thông thường, trợ lý sẽ cung cấp từng lệnh chuẩn xác để bạn thực thi.
02
Dán lời nhắc vào trợ lý AI
Lời nhắc không chứa khoá truy cập. Tên hệ điều hành đổi theo lựa chọn ở trên.
Lời nhắcHãy giúp tôi thiết lập thư viện Python vnstock thế hệ 5 (bản Cộng đồng) trên máy macOS, tuân thủ tài liệu hướng dẫn tại https://vnstocks.com/files/vibe-onboarding.md - Trước khi chạy bất kỳ lệnh nào, hãy trình bày kế hoạch đầy đủ: các bước theo thứ tự, lệnh sẽ chạy ở từng bước, nơi cài, những tệp sẽ tạo hoặc sửa. Chờ tôi duyệt kế hoạch một lần. …
03
Duyệt kế hoạch một lần
Trợ lý nêu các bước và lệnh sẽ chạy. Bạn đồng ý một lần, trợ lý làm trọn rồi chạy thử một đoạn lấy dữ liệu để chắc là dùng được.
Chỉ dùng Claude, ChatGPT hay Gemini bản trò chuyện? Đi đường Low-code.Vnstock MCP
02 · AGENTS.md
Trí nhớ của tác nhân trong dự án
Tác nhân không nhớ gì giữa các phiên. Khối chỉ dẫn trong AGENTS.md là thứ nó đọc đầu tiên mỗi lần mở dự án.
Chỉ ghi vào AGENTS.md của dự án
Không bao giờ ghi vào tệp cấu hình toàn cục của máy.
Nằm trong kế hoạch bạn duyệt
Kèm nội dung dự kiến ghi. Tắt tuỳ chọn thì tác nhân không đụng tới tệp.
Công cụ dùng tệp khác?
Ví dụ CLAUDE.md: nói tên tệp đó trong lời nhắc.
du-an-cua-ban/AGENTS.md
Minh hoạ · nội dung thật ở mục 9 tài liệu
## vnstock (thế hệ 5)
- Python của dự án: ~/.venv/bin/python
- Import: from vnstock import Market, Reference, Fundamental
- Đầu mỗi phiên: chạy vnstock onboard, làm theo quy tắc nó in ra
- Kỹ năng: load_skill_catalog(), rồi load_skill("<tên>")
- Khoá truy cập: không đọc, không in, không hỏi qua khung chat
- Lỗi cài đặt: vnstock doctor03 · Kiểm tra
Nhận biết tác nhân đã hiểu đúng
Nhìn dòng import là biết tác nhân theo chỉ dẫn mới hay đoán từ trí nhớ cũ.
Đúng · thế hệ 5
from vnstock import Market
df = Market().equity("FPT").ohlcv()Sai · cú pháp cũ
from vnstock3 import stock_historical_data df = stock_historical_data(symbol="FPT", ...)
Thấy cú pháp cũ: nhắc tác nhân đọc lại AGENTS.md, hoặc chạy lại vnstock onboard.
04 · Cơ chế
vnstock tự nạp đúng ngữ cảnh
vnstock onboard
In quy tắc dùng thư viện và danh sách kỹ năng mà cấp của bạn đọc được.
load_skill_catalog()
Tác nhân xem kỹ năng nào hợp với việc bạn giao.
load_skill("<tên>")
Nạp quy trình đã biên tập. Khoá đi kèm quyết định kỹ năng nào mở được.
Bước 2: Kho kỹ năng
17 kỹ năng viết sẵn cho tác nhân lập trình, mở theo cấp khoá.
Muốn hỏi ngay trong khung chat?
Đường Low-code dùng Vnstock MCP trong Claude, ChatGPT, Gemini.