hướng dẫn
Kho mã nguồn của bạn, sẵn sàng cho agent trong ba câu lệnh.
Bản dịch có sự hỗ trợ của AI agent. Nếu có khác biệt, trang tiếng Anh là bản có hiệu lực. Nếu bạn thấy vấn đề nào trong văn bản, rất mong bạn mở một issue hoặc gửi một pull request.
Có lẽ bạn đã tới đây qua một huy hiệu. Huy hiệu đó đánh dấu kho mã nguồn có một lớp ngữ cảnh mà agent có thể khởi động từ đó, được kiểm tra và chấm điểm ngay trên máy của người bảo trì theo hình thức tự khai. Việc giúp kho mã nguồn của bạn cũng sẵn sàng cho agent gói gọn trong ba câu lệnh dưới đây.
leji start mở một lớp ngữ cảnh có sẵn, vì vậy kho mã nguồn chưa có lớp này cần áp dụng trước. Bước 02 sẽ thực hiện việc đó; nếu đã có leji.json, bạn có thể đi thẳng tới bước 03. Trang bắt đầu nhanh trình bày quy trình đầy đủ hơn, từ áp dụng Leji cho kho mã nguồn hiện có đến chấm đúng mức mà kho mã nguồn tuyên bố.
01 · Cài CLI
npm install -g @leji-org/leji02 · Áp dụng cho kho mã nguồn
leji adopt03 · Bước vào lớp ngữ cảnh
leji startVừa rồi đã xảy ra chuyện gì
leji startđã mở một agent host phát hiện được, ngay từ gốc kho mã nguồn, kèm đúng một chỉ dẫn: hãy đọc boot profile trước tiên, để ngữ cảnh mở đầu của agent đến từ nhóm chứ không phải do nó tự suy ra từ cây tệp. Đó là một chỉ dẫn, không phải một phép kiểm: leji trỏ agent tới tệp đó chứ không bao giờ xác minh rằng agent đã đọc. Nếu không phát hiện được host nào, hoặc khi chạy trong một script, sẽ không có gì được mở và câu lệnh in ra dòng lệnh để bạn tự chạy.- Trước khi khởi chạy,
leji startin một khối Setup cho bản clone này: hệ thống có tìm được CLI Leji mà kho mã nguồn khai báo, đúng phiên bản nhánh đặc tả của lớp ngữ cảnh yêu cầu hay không; liệu MCP server đã được đăng ký cho host mà nó chọn hay chưa, liệu một tệp.mcp.jsondùng chung đã được commit hay chưa, và liệu hook pre-commit đã được cài hay chưa. Mỗi chỗ thiếu đều được báo kèm câu lệnh khắc phục, và không chỗ nào trong số đó chặn bạn bước vào. - Việc kiểm chính lớp ngữ cảnh thì tách riêng:
leji validatecho schema và các quy tắc lint,leji conformancecho mức mà nó tuyên bố. Cả hai đều chạy từ đúng gói bạn vừa cài, ngay trên máy của bạn, không có dịch vụ nào xen vào. - Công cụ không tự mở kết nối nào, và phía sau nó không có tài khoản, không có sổ đăng ký, cũng không có dịch vụ nào. Những gì chạm tới mạng đều do bạn tự gọi: các lệnh tải về của federation liên hệ đúng kho mã nguồn bạn đã nêu tên, còn bước khai báo phụ thuộc trong
leji initvàleji adoptthì chạy chính trình quản lý gói của bạn khi bạn đồng ý rõ ràng. Agent mà leji khởi chạy chính là agent bạn vốn đã dùng, với hành vi mạng của riêng nó.
Huy hiệu khai điều gì
Huy hiệu được tạo ngay trên máy: leji badge chấm điểm kho mã nguồn bằng leji conformance, ghi ra tệp SVG cho đúng mức mà lần chạy offline đó đã xác minh, rồi in ra một dòng markdown nhúng nó vào.
leji badgeVới một lớp ngữ cảnh được xác minh ở mức governed, huy hiệu trông như thế này:
Dòng markdown nhúng nó vào một README:
[](https://leji.org/agent-ready/)Các mức là core, indexed, governed và federated, mức sau bao hàm mức trước. Danh sách kiểm mức tuân thủ nói mỗi mức đòi hỏi gì ở một nhóm, và mọi mức đều đạt tới được chỉ với bản đặc tả mở và công cụ tham chiếu.
Vì vậy, điều đáng xem là kết quả kiểm tra chứ không phải hình huy hiệu: hãy chạy leji conformance ngay trong kho mã nguồn đó và xem nó báo cáo gì. Trang Tin cậy nói về ai duy trì Leji, nhánh 1.0 hứa hẹn điều gì, và chuyện gì xảy ra nếu đơn vị quản thủ biến mất.