Xây dựng với AI

Tài liệu Fystack được viết cho cả con người và các trợ lý AI mà họ làm việc cùng. Mỗi trang đều có sẵn dưới dạng Markdown gọn gàng, và toàn bộ trang được lập chỉ mục trong tệp llms.txt, nhờ đó các công cụ như Claude Code, Cursor, Codex và ChatGPT có thể đọc trực tiếp tài liệu thay vì phải trích xuất từ HTML.

Cài đặt agent skill của Fystack

Một agent skill là gói hướng dẫn mà trợ lý lập trình sẽ tải khi một tác vụ cần đến. Skill chính thức của Fystack, fystack/agent-skills, hướng dẫn trợ lý của bạn cách xây dựng trên Fystack:

• REST API: mọi endpoint cùng các trường chính, kèm cách ký request bằng HMAC hoặc Ed25519 trong bất kỳ ngôn ngữ nào.
• SDK chính thức: @fystack/sdk cho TypeScript và github.com/fystack/platform-sdk-go cho Go.
• Webhook: xác minh chữ ký và ghi có khoản nạp đúng một lần.
• Phê duyệt: vai trò, nhóm phê duyệt, hạn mức tự động phê duyệt và chính sách, để trợ lý có thể trả lời câu hỏi thiết lập cũng như viết mã.

Skill cũng giữ cho trợ lý của bạn tuân theo các mặc định an toàn: xây dựng trên sandbox trước, không đưa secret vào mã nguồn và không bao giờ bỏ qua bước phê duyệt của con người đối với tiền. Skill đọc tài liệu này trong lúc làm việc, nên luôn được cập nhật khi API thay đổi.

Cài đặt skill cho bất kỳ trợ lý nào hỗ trợ agent skill, bao gồm Claude Code, Cursor, Codex, Gemini CLI và GitHub Copilot:

npx skills add fystack/agent-skills

Trong Claude Code, bạn cũng có thể cài đặt skill dưới dạng plugin:

/plugin marketplace add fystack/agent-skills
/plugin install fystack@fystack

Để cài đặt thủ công, hãy sao chép thư mục skills/fystack từ repository vào thư mục skills của trợ lý, ví dụ .claude/skills/fystack trong dự án của bạn.

Bạn không cần nhắc đến skill sau khi cài đặt. Chỉ cần yêu cầu trợ lý thực hiện một tác vụ Fystack, như tạo ví hoặc xác minh webhook, và trợ lý sẽ tự tải skill.

Tài liệu dạng văn bản thuần

Các công cụ AI hoạt động tốt nhất với văn bản thuần. Markdown dùng ít token hơn nhiều so với HTML đã render và giữ nguyên các đoạn mã mẫu, danh sách tham số và bảng. Fystack xuất bản tài liệu dưới các dạng sau:

• llms.txt: https://docs.fystack.io/llms.txt là bản chỉ mục ngắn gọn của mọi trang kèm mô tả một dòng. Hãy hướng trợ lý của bạn đến đây trước để nó tự tìm được trang phù hợp.
• llms-full.txt: https://docs.fystack.io/llms-full.txt chứa mọi trang trong một tệp duy nhất. Hãy dùng khi bạn muốn trợ lý tải toàn bộ tài liệu cùng lúc và công cụ của bạn còn đủ chỗ trong cửa sổ ngữ cảnh.
• Trang Markdown: thêm .md vào cuối bất kỳ URL tài liệu nào để nhận trang đó dưới dạng Markdown, ví dụ https://docs.fystack.io/wallets.md.
• Thương lượng nội dung: các agent gửi header Accept: text/markdown sẽ nhận Markdown từ URL trang thông thường mà không cần .md.

curl -H "Accept: text/markdown" https://docs.fystack.io/wallets

Sao chép trang vào trợ lý

Mỗi trang đều có nút Copy page bên cạnh tiêu đề. Dùng nút này để:

• Copy page: sao chép trang hiện tại dưới dạng Markdown, sẵn sàng để dán vào bất kỳ cuộc trò chuyện hoặc trợ lý lập trình nào.
• View as Markdown: mở phiên bản Markdown của trang trong tab mới.
• Open in ChatGPT hoặc Open in Claude: bắt đầu cuộc trò chuyện mới đã trỏ sẵn đến trang, để bạn có thể đặt câu hỏi về trang đó ngay lập tức.

Giữ an toàn cho khóa và tiền của bạn