algo-investor-skills: Bộ kỹ năng Claude Code dựng đề xuất gọi vốn chống lừa đảo

Mọi algotrader từng thử huy động vốn từ bên ngoài đều biết bức tường này. Bạn có một chiến lược hoạt động, một lịch sử giao dịch thực trên tài khoản của chính mình, và một đường cong vốn (equity curve) sạch sẽ. Rồi bạn ngồi xuống để viết tài liệu gọi vốn — và bạn phát hiện ra phần khó nhất không phải là chiến lược. Đó là việc thuyết phục một chuyên gia giỏi tính toán, đầy hoài nghi rằng bạn không phải kẻ lừa đảo. Họ sẽ không tin lời bạn nói suông. Vào năm 2026, điều họ thực sự làm là dán bản chào thương mại của bạn vào một LLM không kèm bất kỳ ngữ cảnh nào khác và hỏi: "cái này có thật không, hay là một trò gian lận?"

algo-investor-skills là một bộ kỹ năng Claude Code làm sẵn được xây dựng chính xác cho khoảnh khắc đó. Nó đưa bạn từ các dữ kiện chiến lược thô đến một đề xuất gọi vốn hoàn chỉnh, đã kiểm toán, đa ngôn ngữ — đúng loại tài liệu đáng tin cậy, đặt trung thực lên hàng đầu, có thể sống sót qua bài kiểm tra dán-vào-LLM đầy thù địch đó. Toàn bộ thiết kế dựa trên một quy tắc không thể thương lượng: nó không bao giờ bịa ra một con số.

Một lưu ý ngay từ đầu, cũng là điều mà repo dẫn đầu: mọi thứ trong thư mục reference/ của bộ kit đều là một ví dụ minh họa đã ẩn danh. Tên, sàn giao dịch và các chỉ số đều là dữ liệu giữ chỗ, không phải con số thật. Các kỹ năng tạo tài liệu từ chính lịch sử đã đo lường của bạn — chúng không cung cấp con số thật của bất kỳ ai, và chúng cũng sẽ không bịa ra con số của bạn.

Vì sao đây là một bộ kỹ năng chứ không phải một mẫu (template)

Bạn có thể viết một đề xuất gọi vốn từ một mẫu Word. Người ta vẫn làm vậy, và điều đó lộ ra ngay. Một mẫu tĩnh không thể tính lại chỉ số Sharpe của bạn khi bạn thêm bốn mươi giao dịch, không thể kiểm tra sức chịu đựng (stress-test) lợi thế của bạn khi loại bỏ những giao dịch thắng lớn nhất, và không thể đóng vai một nhà phân bổ vốn (allocator) thù địch để tìm ra điểm yếu trong chính bài chào của bạn. Đó chính là khoảng trống mà algo-investor-skills lấp đầy.

Đây là những kỹ năng Claude Code thuần túy nằm trong .claude/skills/. Mở repo trong Claude Code và chúng tự động tải. Vì chúng là những kỹ năng thông thường, bạn cũng có thể đưa chúng vào bất kỳ dự án nào khác — sao chép các thư mục vào .claude/skills/ cục bộ của một dự án, hoặc vào ~/.claude/skills/ toàn cục theo người dùng để có chúng ở mọi nơi:

cp -r .claude/skills/* /path/to/your/project/.claude/skills/

cp -r .claude/skills/* ~/.claude/skills/

Động cơ mô hình tài chính thậm chí chạy độc lập, không phụ thuộc gì, như một bước kiểm tra tính đúng đắn:

node .claude/skills/algo-financial-models/models.mjs   # in ra một demo đã tính toán

Sáu kỹ năng

Bộ kit cung cấp sáu kỹ năng ghép nối được. Một kỹ năng là bộ điều phối (orchestrator); năm kỹ năng còn lại mỗi cái phụ trách một giai đoạn của pipeline.

Pipeline, từ đầu đến cuối

Các kỹ năng không phải một thực đơn để bạn chọn ngẫu nhiên — chúng tạo thành một pipeline có thứ tự, và investor-docs chạy chúng theo trình tự vì mỗi giai đoạn phụ thuộc vào giai đoạn trước:

intake/intake-template.md   ← bạn điền vào các dữ kiện đã đo lường + giả định được gắn nhãn
        │
        ▼
algo-financial-models   →   các con số / bảng trung thực
        │
        ▼
investor-proof-pack     →   gói minh bạch + kiểm chứng
        │
        ▼
investor-proposal-build →   đề xuất Markdown đầy đủ 14 phần
        │
        ▼
investor-doc-localize   →   biến thể ngôn ngữ / thị trường   (tùy chọn)
        │
        ▼
investor-proposal-audit →   vòng lặp nhà đầu tư hoài nghi đến khi đạt  (BẮT BUỘC)

1. Intake — nguồn sự thật duy nhất

Mọi thứ bắt đầu với intake/intake-template.md. Bạn điền vào luận điểm chiến lược, lịch sử đã đo lường của mình (cỡ mẫu, tỷ lệ thắng, giao dịch trung bình, Sharpe, Sortino, sụt giảm tối đa, khoảng thời gian), các sàn giao dịch và kiến trúc tài khoản, cùng các điều khoản thương mại. Quan trọng là, bạn đánh dấu mỗi con số hoặc là [real] (đã đo lường) hoặc là một giả định tương lai được gắn nhãn rõ ràng (đòn bẩy, số lượng tranche, độ sâu giả định, trượt giá, suy giảm alpha).

Quy tắc khiến toàn bộ bộ kit đáng tin cậy nằm ở đây: bất cứ thứ gì bạn để trống đều trở thành một ô TODO rõ ràng trong bản nháp, không bao giờ là một con số bịa ra. Nếu bạn không thể chứng minh một con số bằng dữ liệu xuất ra từ sàn giao dịch của mình, bạn để trống nó, và bộ kit từ chối tô vẽ che lấp khoảng trống đó.

2. algo-financial-models — các con số trung thực

Kỹ năng này biến đầu vào đã đo lường của bạn thành sáu mô hình định lượng, được xuất ra dưới dạng các bảng Markdown gắn trực tiếp, mỗi bảng kèm một chú thích trung thực một hoặc hai dòng:

• Kỳ vọng và định cỡ vị thế — giá trị kỳ vọng, sigma mỗi giao dịch, tỷ lệ payoff, sức chứa (capacity), lợi thế ròng, và phần Kelly (Kelly fraction).
• Cầu nối lợi nhuận — bốn bậc từ lợi thế thô mỗi sự kiện đến con số đã điều chỉnh theo sức chứa, sau phí, sau suy giảm. Nó luôn hiển thị cả lợi thế thô lẫn lợi thế đã điều chỉnh theo sức chứa, bởi vì con số thô mỗi sự kiện không phải là lợi nhuận mà quỹ có thể thực hiện được, và giả vờ ngược lại chính xác là kiểu thiếu trung thực mà bộ kit tồn tại để ngăn chặn.
• Lịch tính phí theo mốc cao nhất (high-water-mark) — chỉ tính phí hiệu suất, thu trên các đỉnh vốn mới.
• Các chỉ số quant — giải ngược ra sigma và độ lệch giảm (downside deviation) sao cho Sharpe và Sortino đã đo lường của bạn được tái tạo chính xác. Chúng là các giá trị truyền thẳng qua; bộ kit sẽ không ghi đè hay tô vẽ chúng.
• Monte-Carlo (GBM) — các đường P5 / P50 / P95 cùng xác suất phá sản, với suy giảm alpha được tính vào.
• Độ bền alpha + Wilson CI — một lịch suy giảm lợi thế và một khoảng tin cậy tỷ lệ thắng cho mẫu nhỏ, để một con số 62%-trên-80-giao-dịch không bao giờ được trình bày như thể nó là một quy luật của tự nhiên.

Một chi tiết tôi thấy thực sự sắc bén: mức phơi nhiễm hiệu dụng mỗi sự kiện được tính bằng leverage / tranches (L / N), và bảng quét phơi nhiễm được tô màu đối chiếu với Kelly — xanh lá tại hoặc dưới mức nửa Kelly, hổ phách lên đến Kelly đầy đủ, đỏ ở trên mức đó. Điều đó biến câu hỏi "tôi nên đặt cược bao nhiêu?" từ một cảm tính thành một bảng số mà bạn có thể bảo vệ.

3. investor-proof-pack — sự trung thực có thể kiểm chứng được

Đây là phần mà những người hoài nghi thực sự quan tâm. Gói chứng minh (proof pack) tập hợp một gói minh bạch chứng minh lịch sử giao dịch thực của bạn là thật mà không làm lộ bí quyết cốt lõi và không bịa ra bất cứ thứ gì:

• Một bảng giao dịch được công bố với các cột cố định (# | Venue | Pair | Date | Side | PnL % | Hold time | Status) liệt kê tất cả giao dịch trong khoảng thời gian — cả giao dịch thắng lẫn thua. Việc chọn lọc thiên vị (cherry-picking) bị cấm rõ ràng. Phần trăm và ngày tháng được hiển thị; số tiền cụ thể được cố ý giữ lại, và bộ kit nêu rõ ranh giới đó bằng lời lẽ rõ ràng.
• Một phương pháp đối chiếu độc lập với hai hướng phải khớp nhau: đối chiếu theo order-id qua REST API của sàn (tính lại P&L đã thực hiện từ các lệnh khớp một cách chính xác), và đối chiếu sao kê với bản xuất lịch sử giao dịch chính thức của sàn (khớp theo ký hiệu + thời gian + dấu trong một dung sai đã nêu). Hai phép đối chiếu độc lập mà khớp nhau thì khó làm giả hơn nhiều so với một phép.
• Một lời mời kiểm chứng "Bước 0" chỉ-đọc: một script mà nhà đầu tư tự chạy bằng một khóa API chỉ-đọc do chính họ tạo ra, đối chiếu các giao dịch được công bố với dữ liệu của chính sàn — trước khi cấp bất kỳ khóa có quyền giao dịch nào.
• Biểu đồ — các minh họa tổng hợp (được gắn nhãn rõ ràng, để dạy cơ chế giao dịch) bên cạnh các biểu đồ nến thật từng cây với các điểm đánh dấu vào/ra gắn với các lệnh khớp đã đối chiếu.

Và phần phân biệt cái này với một bộ slide chào hàng: gói chứng minh nói rõ ranh giới của chính nó. Việc đối chiếu chứng minh tính xác thực và độ lớn của các giao dịch thực trong quá khứ. Nó không chứng minh lợi nhuận tương lai, nó không chứng minh lợi thế còn giữ được ở quy mô lớn, và nó không phải một cuộc kiểm toán đầy đủ. Bằng chứng mạnh nhất, bộ kit nói thẳng, là một thử nghiệm tiên phong (forward pilot) trên chính tài khoản của nhà đầu tư.

4. investor-proposal-build — cung 14 phần

Kỹ năng này lắp ráp một tài liệu Markdown duy nhất, khép kín mà một nhà đầu tư thù địch có thể dán toàn bộ vào một LLM và mổ xẻ. Cấu trúc là một cung 14 phần có chủ đích, dẫn đầu bằng rủi ro và việc lưu ký (custody), không phải lợi nhuận:

1. Luận điểm — với mỏ neo lưu ký như một câu một dòng ngay trong đoạn văn đầu tiên.
2. Lợi thế đến từ đâu — sự kém hiệu quả mang tính cấu trúc, với một cảnh báo trung thực rằng các nghiên cứu bên ngoài không được trình bày như kết quả của chính người vận hành.
3. Các chỉ số nổi bật — Sharpe / Sortino / sụt giảm tối đa, được ghi chú là các tỷ số bất biến với đòn bẩy, dẫn đầu bằng Sortino, kèm theo cảnh báo về mẫu nhỏ.
4. Mô hình lưu ký và vận hành — khóa API chỉ-giao-dịch, không có quyền rút tiền, thu hồi một-cú-nhấp như "phanh khẩn cấp", được nêu là mô hình duy nhất được đưa ra.
5. Minh bạch giao dịch thật — gói chứng minh từ bước 3.
6. Các giai đoạn vốn — thử nghiệm tiên phong (~$50k, phí ký quỹ escrow, 0% cho đến khi mốc cao nhất phục hồi), mở rộng, rồi đến mục tiêu.
7. Mô hình phí — một mức phí hiệu suất cụ thể tính theo phần trăm lợi nhuận ròng, có mốc cao nhất và không có phí quản lý.
8. Hai rủi ro được nêu tên — chưa-kiểm-chứng-ở-quy-mô (thanh khoản thoát lệnh) và cửa sổ nắm giữ siêu ngắn, nêu ra mà không né tránh.
9. Một bảng kịch bản thất bại đã định lượng — nhà đầu tư mất gì trong mỗi kịch bản, gắn với phép toán N-tranche.
10. Trách nhiệm pháp lý và phân bổ rủi ro — bao gồm cảnh báo trung thực về việc không-có-pháp-nhân / khả-năng-truy-đòi-hạn-chế.
11. Phân tách vốn qua N tài khoản cấp cao nhất riêng biệt (không phải tài khoản con, vốn có thể đổ dây chuyền khi bị đóng băng), với một mức trần theo từng sàn.
12. Độ bền alpha — giả định suy giảm tường minh và trần sức chứa, được trình bày như một giả định tương lai.
13. Người vận hành — một người, một cổ họng để siết, được nêu vừa là một đặc tính thẳng hàng lợi ích vừa là một rủi ro nhân sự chủ chốt.
14. Lộ trình — được gắn nhãn rõ ràng "không phải lời hứa".

Toàn bộ tài liệu được dựng theo hướng ít thổi phồng ngay từ cấu trúc. Nếu một câu nghe giống bộ slide chào hàng, kỹ năng sẽ cắt nó đi. Việc lưu ký và phanh khẩn cấp đến trước bất kỳ con số lợi nhuận nào, và mọi phần có thể bị đọc như khoe khoang đều được cân bằng bởi rủi ro tương ứng trong cùng hơi thở.

5. investor-doc-localize — dịch thuật không trôi lệch

Tùy chọn, nhưng được thiết kế tốt. Nó bản địa hóa bản gốc đã hoàn thiện sang en / ru / zh / ko (có thể mở rộng), và thậm chí tạo ra các biến thể đặc thù theo thị trường — ví dụ, một biến thể thị trường cô lập làm nổi bật lợi thế cấu trúc cho một đối tượng hiểu trực tiếp về sàn giao dịch, so với một biến thể công khai đã được làm sạch. Tội lỗi lớn nhất mà nó đề phòng: để một con số trôi lệch hoặc một cảnh báo bị làm nhẹ đi vì nó "đọc hay hơn" ở một ngôn ngữ khác. Mọi phần trăm phí, mọi điều khoản lưu ký, mọi kịch bản thất bại đều được kết xuất giống hệt nhau qua các ngôn ngữ, với một bước kiểm tra dịch ngược (back-translation) ngẫu nhiên trên các phần về lưu ký, phí và trách nhiệm pháp lý.

6. investor-proposal-audit — cổng bắt buộc

Đây là kỹ năng khiến bộ kit không chỉ là một bộ tạo tài liệu. Nó mô phỏng chính xác bước kiểm tra mà một nhà đầu tư nghiêm túc thực hiện: một nhà đầu tư AI mới tinh, chỉ-dựa-vào-tài-liệu — không có code, không có lịch sử giao dịch, không có sự ưu ái — đọc đề xuất và trả về một phán quyết có cấu trúc: satisfaction (0–100), wouldInvest, scamRisk (thấp / trung bình / cao), các quan ngại hàng đầu, thông tin còn thiếu, các dấu hiệu cảnh báo, và các điểm mạnh. Sau đó một tác nhân chỉnh sửa khắc phục những gì người hoài nghi gắn cờ — một cách trung thực — và vòng lặp lặp lại.

Thang điểm mặc định nghiêng về hoài nghi. Nó tưởng thưởng cho những hạn chế trung thực, cơ chế kiểm chứng cụ thể, điều khoản phí và lưu ký tường minh, và phần rủi ro được định lượng. Nó phạt nặng: các tính từ tiếp thị, kiểu "hãy tin chúng tôi" với các con số bị giấu, sự mơ hồ về tiền bạc, các tuyên bố không thể kiểm chứng, và các mâu thuẫn nội tại — kiểu kinh điển là xin một khoản lớn trong khi thừa nhận sức chứa mỗi sự kiện là rất nhỏ.

Các quy tắc của tác nhân chỉnh sửa là cốt lõi đạo đức của toàn bộ bộ kit. Nó không bao giờ thổi phồng một chỉ số, không bao giờ xóa một cảnh báo, không bao giờ bịa ra một lịch sử giao dịch. Cách để khắc phục "không thể kiểm chứng" là bổ sung bằng chứng có thể đề nghị — quyền truy cập API chỉ-đọc, sao kê xuất từ sàn, một thử nghiệm tiên phong nhỏ có trả phí, ký quỹ escrow phí hiệu suất — chứ không phải tuyên bố quá lố. Một tài liệu chỉ "hoàn thành" khi satisfaction >= 88 và scamRisk không phải high, sau ít nhất hai lần lặp. Một đề xuất chưa qua cuộc kiểm toán này, theo định nghĩa, là một bản nháp chứ không phải một sản phẩm bàn giao.

Các nguyên tắc thiết kế (và vì sao chúng quan trọng với một nhà phân bổ vốn)

Repo nêu ra bốn nguyên tắc không thể thương lượng, và chúng đáng được đọc như một tuyên ngôn cho việc gọi vốn trung thực:

• Không bao giờ bịa. Mọi con số đều truy ngược về dữ liệu đã đo lường hoặc một giả định tương lai được gắn nhãn rõ ràng. Các dữ kiện còn thiếu trở thành những ô TODO hiển thị rõ, không phải con số bịa ra.
• Đặt trung thực lên hàng đầu, ít thổi phồng. Dẫn đầu bằng rủi ro và lưu ký. Nêu tên các hạn chế. Đề nghị kiểm chứng thay vì xin lòng tin.
• Lưu ký mang tính cấu trúc, không phải lời hứa. Khóa API chỉ-giao-dịch trên các tài khoản do nhà đầu tư sở hữu, không có quyền rút tiền, có thể thu hồi bằng một cú nhấp.
• Cổng kiểm toán là bắt buộc. Một tài liệu chưa hoàn thành cho đến khi vòng lặp nhà đầu tư hoài nghi đạt yêu cầu.

Nếu bạn từng đọc một bài chào hàng algotrading và cảm thấy sự hoài nghi của mình dâng lên theo mỗi từ ngữ cường điệu, bạn sẽ hiểu vì sao sự đảo ngược này có hiệu quả. Lòng tin không được xây bằng cách tuyên bố nhiều hơn; nó được xây bằng cách tuyên bố chính xác những gì bạn có thể chứng minh, và bằng cách trao cho người đọc các công cụ để tự họ kiểm tra.

Một nhà đầu tư algo thực sự sử dụng nó như thế nào

Trong thực tế, quy trình rất ngắn:

1. Mở repo trong Claude Code để các kỹ năng tự động tải.
2. Sao chép mẫu intake và điền vào lịch sử đã đo lường cùng các giả định tương lai được gắn nhãn rõ ràng, để trống ở những chỗ bạn không có dữ liệu.
3. Yêu cầu Claude: "Chuẩn bị một tài liệu gọi vốn cho chiến lược của tôi." Việc đó kích hoạt bộ điều phối investor-docs, chạy pipeline từ đầu đến cuối.
4. Cổng kiểm toán chạy cuối cùng và lặp cho đến khi mức hài lòng đủ cao và rủi ro lừa đảo không còn ở mức cao.

Thứ bạn nhận được là một file Markdown duy nhất: di động, khép kín, và được dựng để sống sót qua bài kiểm tra dán-vào-LLM mà một nhà phân bổ vốn thực sự dù sao cũng sẽ bắt nó trải qua.

Vị trí của nó trong hệ sinh thái Marketmaker / tác nhân AI

Chúng tôi đã viết rất nhiều trên blog này về các tác nhân AI đưa ra quyết định giao dịch — các quỹ đa tác nhân, các ủy ban phân tích LLM, các hệ sinh thái học tăng cường (reinforcement learning). algo-investor-skills nằm ở một lớp xa hơn một bậc, ở một vấn đề mà những dự án đó hầu như bỏ qua: một khi một chiến lược tự động hoạt động, làm thế nào để bạn truyền đạt nó một cách đáng tin cậy đến nguồn vốn? Đây là khuôn mẫu AI tác nhân hướng vào quan hệ nhà đầu tư và thẩm định (due diligence) thay vì vào việc tạo tín hiệu. Hình thái bộ-điều-phối-cộng-các-chuyên-gia — một kỹ năng sắp xếp trình tự, vài kỹ năng mỗi cái phụ trách một giai đoạn — chính là kiến trúc tác nhân ghép nối được mà chúng tôi liên tục thấy giành chiến thắng, ở đây được áp dụng cho một pipeline tài liệu hóa và kiểm chứng thay vì cho một sổ lệnh.

Với một algotrader nghiêm túc, đó là một mảnh hạ tầng có ý nghĩa. Chiến lược là lợi thế của bạn; đề xuất đã kiểm toán, đặt trung thực lên hàng đầu là thứ cho phép lợi thế đó thu hút vốn mà bạn không phải trở thành một người làm tiếp thị hay đánh đổi uy tín của mình. Lập trường của bộ kit — kiểm chứng thay vì lòng tin, rủi ro trước lợi nhuận, không bao giờ có con số bịa đặt — chính xác là lập trường sống sót được khi va chạm với một nhà phân bổ vốn chuyên nghiệp.

Những cảnh báo trung thực

Đây là một dự án ở giai đoạn đầu, do một người duy trì, và repo cũng nói rõ như vậy. Đề xuất và mô hình tham chiếu là các ví dụ minh họa đã ẩn danh, không phải con số thật — giá trị của bộ kit nằm ở quy trình và kỷ luật, không phải ở bất kỳ con số nào được cung cấp. Vòng lặp kiểm toán chỉ tốt ngang bằng với mô hình đang chạy nó, và một điểm số đạt yêu cầu trên giấy vẫn chỉ là điểm số trên giấy: như chính bộ kit khẳng định, bằng chứng mạnh nhất luôn là một thử nghiệm tiên phong trên chính tài khoản của nhà đầu tư. Bộ kit tạo ra tài liệu; nó không đưa ra lời khuyên về tài chính, pháp lý hay thuế, và kết quả trong quá khứ hay kết quả backtest không đảm bảo kết quả trong tương lai.

Không điều nào trong số đó làm suy yếu ý tưởng cốt lõi. Công việc khó khăn, trung thực của việc chuẩn bị tài liệu gọi vốn — tính toán những con số có thể tái tạo, xây dựng một gói chứng minh có thể kiểm tra, dẫn đầu bằng rủi ro, và sống sót qua một cuộc đánh giá thù địch — chính xác là công việc mà bộ kit này hệ thống hóa.

Liên kết

• GitHub: suenot/algo-investor-skills

Kết luận

algo-investor-skills là một repo nhỏ với một luận điểm kỷ luật khác thường: cách để huy động vốn cho một chiến lược algotrading không phải là chào hàng mạnh hơn mà là trung thực có thể kiểm chứng được. Sáu kỹ năng Claude Code biến luận điểm đó thành một pipeline — đầu vào là các dữ kiện đã đo lường, đầu ra là những con số có thể tái tạo, một gói chứng minh có thể kiểm chứng, một đề xuất 14 phần đặt rủi ro lên trước, một bản bản địa hóa trung thực tùy chọn, và một cuộc kiểm toán nhà đầu tư hoài nghi bắt buộc khắc phục các điểm yếu bằng cách bổ sung bằng chứng chứ không phải bằng cách tuyên bố quá lố.

Nếu bạn vận hành một chiến lược thật và đã từng mắc kẹt trước bức tường tài liệu gọi vốn, điều này đáng để dành ra một buổi chiều. Điền vào intake, chạy bộ điều phối, để người hoài nghi mổ xẻ bản nháp của bạn, và bàn giao một tài liệu nói chính xác những gì bạn có thể chứng minh — và trao cho người đọc các công cụ để xác nhận điều đó.