Cho người
Bất kỳ ai trong nhóm cũng đọc được đúng lớp ngữ cảnh mà agent được trỏ tới. leji view mở lớp ngữ cảnh dùng chung dưới dạng dễ đọc ngay trong trình duyệt.
/LEH-jee/◆Bản đặc tả mở & bộ công cụ
Làm cho ngữ cảnh
của bạn đọc được.
Leji đưa phần chủ ý vốn bị vùi trong các cuộc chat của nhóm và chỉ dẫn riêng của từng công cụ về một nơi: lớp ngữ cảnh dùng chung do chính nhóm bạn sở hữu và xem xét. Leji chuẩn hoá hình thái và cách quản trị, chứ không chuẩn hoá nội dung. Nhờ đó, người và agent cùng đọc một nguồn, còn công cụ kiểm tra giúp phát hiện sự trôi lệch.
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.
$ leji adopt --yes --wire-adapters Wrote 16 files (context root: docs/): .leji/work/onboarding-brief.md AGENTS.md docs/agents/core.md … $ leji validate ok (0 errors, 0 warnings) $ leji conformance ok (0 errors, 0 warnings; claimedLevel: core, verifiedLevel: core, processAttested: 4)
npm install -g @leji-org/lejiMiễn phí & mã nguồn mở · Apache-2.0 · CC-BY-4.0
Áp dụng, không phải di dời
Bắt đầu từ chính kho mã nguồn bạn đang có.
CLI dựng khung một lớp ngữ cảnh lên trên cây tệp bạn vốn đã có. Không có gì bị di chuyển, và một điểm vào chỉ thay đổi khi bạn yêu cầu bằng --wire-adapters.
- Trước hết
Dựng khung quanh cây tệp của bạn
adoptdùng lại thư mục gốc của tài liệu hiện có, tạo sẵn các tệp index danh mục và đưa nội dung từ điểm vào hiện tại của agent vào lớp ngữ cảnh. Không tệp nào bạn đã viết bị di chuyển; điểm vào cũng chỉ được viết lại khi bạn yêu cầu bằng--wire-adapters. - Rồi
Agent của bạn đề xuất cách ánh xạ
Brief onboarding yêu cầu agent đọc kho mã nguồn rồi đề xuất tài liệu nào thuộc danh mục nào. Bạn xem xét đề xuất đó như xem xét mọi thay đổi khác.
- Về sau
Được quản trị từ đó trở đi
Mọi thay đổi đều đi qua cổng xem xét sẵn có của kho mã nguồn. Các phép kiểm trong CI phát hiện sự trôi lệch, còn hạn tươi làm lộ phần ngữ cảnh đã cũ.
Con người đọc, agent truy cập
Một nguồn, hai nhóm đối tượng.
Một bản ghi thuộc về kho mã nguồn, thể hiện cách nhóm bạn suy nghĩ: ngôn ngữ của lĩnh vực, các ràng buộc, các quyết định, các quy ước, các ràng buộc bảo vệ cho agent. Một nguồn duy nhất, thay đổi qua một cổng xem xét duy nhất.
Lớp ngữ cảnh dùng chungthay đổi qua vòng xem xét
Cho agent
Agent bước vào qua boot profile, đúng một tệp nói rõ phải nạp gì trước một tác vụ; các tệp điểm vào (AGENTS.md, CLAUDE.md) chuyển hướng về đó thay vì tự giữ một bản sao. MCP server trao cho chúng bản đặc tả cùng các schema và cho phép chúng kiểm tra và chấm mức tuân thủ ngay trong giao diện đó, không cần gọi CLI.
Mức tuân thủ
Tuyên bố một mức, rồi kiểm lại nó.
Bốn mức, mức sau bao hàm mức trước, được chấm theo những gì hiện diện chứ không theo mức trưởng thành tự đánh giá. Phần lớn các nhóm đi tới governed rồi dừng. CLI kiểm những gì máy kiểm được; phần còn lại do nhóm bạn đứng ra bảo đảm.
- coreNgữ cảnh dùng chung của nhómmanifest, boot profile, nội dung thật, một quyết định đầu tiên, một chủ sở hữu được nêu tên.
- indexedĐọc được đối với công cụmột index được sinh ra và một changelog máy đọc được.
- governedĐã qua xem xét, có kiểm trôi lệchxem xét qua pull request, agent profile, CI, và hạn tươi được kiểm.
- federatedThực hành ở quy mô tổ chứcmột mount có ghim trong các kho mã nguồn khác, kèm báo cáo pin lỗi thời. Federation hoạt động thế nào.
Vì sao nó được dựng theo cách này
Chủ ý bền vững, chia sẻ trong một vòng tròn, kiểm bằng cơ chế.
Chủ ý thay vì chỉ dẫn
Chủ ý bền vững thuộc về một lớp ngữ cảnh duy nhất đã qua xem xét, nơi người và agent tự suy ra hành động từ đó. Các điểm vào của nhà cung cấp chuyển hướng về đó, nên ngữ cảnh của một nhóm AI-native sống lâu hơn mọi công cụ. Vì sao chủ ý bền lâu.
Một vòng tròn, không phải một tầng
Người với người, người với AI, và người với AI với người đều được coi trọng ngang nhau quanh cùng một lớp ngữ cảnh dùng chung. Ai cũng đọc, ai cũng đề xuất, và con người phê duyệt qua pull request. Vì sao vòng tròn hiệu quả.
Cơ chế thay vì thiện chí
Thực tế luôn thay đổi, còn ngữ cảnh dùng chung sẽ dần xuống cấp. Việc xem xét code, các phép kiểm những dạng trôi lệch máy kiểm được và hạn tươi đưa việc bảo trì vào cơ chế vận hành thay vì để nó trông vào thiện chí; ngữ cảnh lỗi thời không bao giờ bị âm thầm coi là còn hiệu lực. Vì sao cơ chế mới là thứ quan trọng.
Điểm vào cho máy
Một tệp manifest
Cây docs/ sẵn có của bạn tuân thủ bằng cách ánh xạ, chứ không phải đổi tên. Một tệp leji.json duy nhất ở gốc kho mã nguồn khai báo gốc ngữ cảnh, boot profile, các ánh xạ danh mục, và tuyên bố mức tuân thủ.
Một lớp ngữ cảnh tinh gọn không cần tệp nào của nhà cung cấp: lệnh triệu tập trỏ thẳng agent host tới boot profile, hoặc leji start mở ngay một host đã phát hiện được tại đó.
Các tệp điểm vào chỉ là con trỏ, không bao giờ là nơi chứa ngữ cảnh. AGENTS.md là tệp dùng chung mà nhiều agent host đều đọc; hướng dẫn áp dụng nói nốt phần còn lại.
{
"leji": "1.0",
"name": "acme-billing-context",
"description": "Shared context layer for this repository.",
"rootPath": "docs/",
"bootProfilePath": "docs/boot-profile.md",
"categories": {
"domain": { "indexes": ["docs/context/domain.md"] },
"system": { "indexes": ["docs/context/system.md"] },
"governance": { "indexes": ["docs/context/governance.md"] },
"decisions": { "indexes": ["docs/context/decisions.md"] }
},
"owners": { "primary": { "name": "Acme Platform Team", "contact": "platform@acme.example" } },
"conformance": { "claimedLevel": "core" },
"vendorAdapters": ["AGENTS.md"]
}