Nhập tài nguyên từ GitHub, GitLab
Nếu một skill, agent hay plugin đã nằm trong repo GitHub hoặc GitLab, bạn không cần đóng gói lại. Dán repo vào, Tara tìm những gì có trong đó, quét, rồi đăng các mục bạn chọn.
Trên Portal, vào Contribute › Create resource › Import from GitHub or GitLab. Trên terminal:
ph tara import github acme/tools # kho cá nhân (mặc định)
ph tara import github acme/tools@v1.2/skills --to acme # một thư mục ở một tag, vào tổ chức acme
ph tara import github https://github.com/acme/tools --only skill-review,sql-helper --yes
ph tara import https://gitlab.com/acme/platform/tools/-/tree/main/skills --to acme # GitLab, một thư mục trên một nhánhph tara import <nguồn> dùng được cho cả hai. import github <nguồn> và import gitlab <nguồn> vẫn chạy như tên gọi cũ, vì chính nguồn quyết định nhà cung cấp.
Dán được gì
owner/repo, owner/repo@ref (nhánh, tag hoặc commit), owner/repo/thư-mục, owner/repo@ref/thư-mục, hoặc một URL GitHub.
Với GitLab, hãy dán URL của project: https://gitlab.com/group/subgroup/project, một thư mục hoặc nhánh như https://gitlab.com/group/project/-/tree/v1.2/skills, link tới tệp (/-/blob/), hoặc git@host:group/project.git. Đường dẫn group có thể gồm subgroup. Host nào khác github.com đều được coi là GitLab, và phải là gitlab.com hoặc host mà người vận hành đã cho phép. Nếu không, Tara từ chối với host_not_allowed và không gọi tới host đó.
Tara đổi ref thành commit trước rồi đọc đúng commit đó, nên thứ bạn xem cũng là thứ được nhập. Commit, đường dẫn và giấy phép được ghi vào gói.
Tara tìm thấy gì
| Trong repo | Thành |
|---|---|
Plugin (.claude-plugin/plugin.json, hoặc các mục cục bộ của marketplace.json) | kit nếu có hook hoặc MCP server, không thì skill, agent hoặc prompt |
Thư mục skill (có SKILL.md) | skill |
Agent (.claude/agents/*.md) | agent |
Lệnh (.claude/commands/*.md) | skill loại prompt |
.mcp.json | kit |
Bạn thấy danh sách và chọn mục cần nhập. Tên có dạng <chủ>/<loại>-<tên>, trong đó chủ là đích đến: handle của bạn, hoặc slug tổ chức.
Nhập vào đâu
- Kho cá nhân (mặc định, riêng tư). Dùng
--personal, hoặc bỏ--to. - Tổ chức của bạn, với
--to <org>. Bạn cần có quyền đăng ở đó. Thành viên của tổ chức thấy các mục này.
Bạn không nhập vào kho chính thức (aiforge/) được. Repo riêng tư chỉ vào được tổ chức có installation GitHub App chứa repo đó, không bao giờ vào kho cá nhân, và không bao giờ công khai. Mục nhập vào lúc đầu là riêng tư hoặc nội bộ. Muốn công khai thì theo luật cộng đồng, và mục không có giấy phép thì không bao giờ công khai được.
Repo công khai không cần đăng nhập GitHub hay GitLab. Với repo riêng tư, Tara đọc bằng installation của tổ chức, và chỉ khi repo nằm trong installation đó. Trên GitLab, luật này dùng kết nối GitLab của tổ chức: repo riêng tư chỉ được đọc khi nằm trong group đã kết nối, chỉ cho người có quyền đăng vào tổ chức đó, và chỉ vào đúng tổ chức đó.
Bộ quét và giấy phép
Mỗi mục được đóng thành gói bình thường và qua đúng các bước kiểm như khi tải lên (mã độc, luật, và model review nếu có cấu hình). Qua hết thì phát hành ngay, không duyệt tay. Mỗi mục trả về một kết quả:
| Kết quả | Ý nghĩa |
|---|---|
published | Đã nhập thành version mới |
unchanged | Nội dung giống lần nhập trước, nên không tạo gì |
scan_failed | Một bước kiểm tìm ra vấn đề. Các phát hiện được liệt kê |
rejected | Phát hiện mã độc |
blocked_license | Giấy phép không cho phép ở đây |
failed | Lỗi khác |
Nhập lại chỉ tạo version mới khi nội dung của mục đổi. Tên đã bị thứ không đến từ repo này chiếm thì bị từ chối.
Chính sách giấy phép. Tara tôn trọng giấy phép của repo:
| Giấy phép | Nhập vào đâu được |
|---|---|
| MIT, Apache-2.0, BSD-2/3, ISC, Unlicense, CC0, 0BSD, MPL-2.0, CC-BY-4.0 và nhóm GPL, LGPL, AGPL | Mọi đích. Văn bản giấy phép được giữ trong gói |
| Không có giấy phép (mặc định của GitHub và GitLab là giữ mọi quyền) | Chỉ kho cá nhân, riêng tư, như clone về máy |
| Độc quyền hoặc "all rights reserved", phi thương mại, cấm sửa đổi, BUSL, SSPL, hoặc văn bản Tara không nhận ra | Chặn ở mọi nơi |
Repo của chính bạn thì không cần giấy phép khi nhập vào kho cá nhân (login GitHub trùng handle của bạn), hoặc vào tổ chức có installation GitHub hay group GitLab chứa repo đó. Với GitLab, kho cá nhân không bao giờ được miễn như vậy, vì namespace GitLab không gắn với handle.
Giới hạn
Tara tải repo dưới dạng một tệp nén (với GitLab cũng vậy, tại đúng commit đã chốt), tối đa 50 MiB, giữ tối đa 10.000 tệp và 200 MiB, mỗi tệp tối đa 10 MiB, trong 2 phút. Tara bỏ qua symlink, tệp đặc biệt, tệp quá lớn và đường dẫn không an toàn, đồng thời báo lại. Phần còn lại vẫn được nhập.