Tiêu chí duyệt
Đọc trang này để chuẩn bị bài gửi sao cho qua được ngay lần đầu, và hiểu vì sao bài của mình bị chặn. Trang nói về hai việc: Tara kiểm tự động những gì ở mọi version, và người duyệt của PhillipCLI đọc những gì trước khi duyệt bản vào kho chính thức.
Bài gửi đi qua những bước nào?
Bài gửi vào kho cá nhân hoặc vào tổ chức đi theo thứ tự: gửi, kiểm tự động, ký số, phát hành, rồi thông báo. Không ai duyệt tay. Nếu bộ quét không chặn thì version được phát hành ngay. Chỉ bài gửi vào kho chính thức (aiforge/<tên>) mới còn phải chờ nhân sự nền tảng PhillipCLI duyệt, trong Portal ở Cài đặt, mục Platform, rồi Duyệt kho chính thức. Tài nguyên public theo luật cộng đồng (đọc phần cuối trang).
Vuốt ngang để xem hết sơ đồ.
Bạn xem kết quả kiểm bất kỳ lúc nào bằng hai lệnh sau.
ph tara check ./thu-muc-tai-nguyen
ph tara status ten-tai-nguyen@1.0.0Mức độ của một phát hiện
| Mức | Hậu quả |
|---|---|
error | Chặn phát hành. Bạn sửa rồi gửi version mới |
warning | Người duyệt (kho chính thức) cân nhắc, có thể duyệt kèm lời nhắc |
info | Thông tin cho người đọc, ví dụ danh sách thành phần chạy được |
malware | Bộ quét mã độc khớp. Bài bị từ chối và gói bị xóa ngay |
Ở tài nguyên chính thức, nhiều phát hiện về nội dung chỉ ở mức warning vì có người đọc và quyết định. Tài nguyên cá nhân và của tổ chức không có ai đọc, tài nguyên public còn ít hơn, nên cùng phát hiện đó có thể thành error, thường gặp nhất khi bạn mở public.
Tara kiểm tự động những gì?
Manifest và cấu trúc
Tara đọc plugin.json và kiểm version có phải semver không, có description và author.name chưa. Khối metadata.forge phải đủ: schema, type, owners đúng dạng email, engines hợp lệ, status là active hoặc deprecated, vai trò nằm trong danh sách cho phép, org là aiforge, một tổ chức bạn tham gia hoặc chính tên bạn (hoặc không có org, nghĩa là kho cá nhân), và model có trong catalog. Tên phải đúng quy tắc của loại tài nguyên, xem Sáu loại tài nguyên.
Cấu trúc thư mục kiểm theo loại. Agent cần agents/*.md. Skill và prompt cần skills/*/SKILL.md. Harness cần template/CLAUDE.md và dependencies. Kit cần ít nhất một dạng kết nối. Loại nào cũng cần README.md và CHANGELOG.md, trong đó CHANGELOG.md phải có mục ## <version> cho đúng version đang gửi.
Về phụ thuộc, tài nguyên được trỏ tới phải tồn tại và đã phát hành, ràng buộc phải hợp lệ và thỏa được, và không được trỏ ra marketplace khác. Tài liệu đi kèm phải đúng loại, định dạng và kích thước, và kit hay harness phải có install và usage.
Kiểm của Claude Code
Tara chạy claude plugin validate --strict trên gói. Nếu máy bạn đã cài Claude Code thì chạy cùng lệnh này trước khi gửi.
Secret
Gói không được chứa credential. Tara quét các mẫu token và khóa phổ biến. Bạn cất secret ở nơi khác (kit nhận chúng qua connect) và đừng dán token mẫu thật vào README.
Thành phần chạy được
Script (.sh, .py, .mjs…), thư mục bin/, hook, máy chủ MCP và file nhị phân đều được liệt kê ở mức info. Tài nguyên cá nhân và của tổ chức được chứa chúng, và ai cài tài nguyên cũng chạy mã đó, nên bạn hãy giữ mã ngắn, dễ đọc và không tải thêm mã từ bên ngoài. Ở kho chính thức, người duyệt đọc từng dòng. Tài nguyên public thì không được có thành phần chạy được.
Nội dung
Tara soi nội dung theo sáu nhóm. Ký tự ẩn gồm chữ giấu mà model đọc được và ký tự đảo chiều hiển thị. Prompt injection là chỉ dẫn bảo agent bỏ qua quy tắc, giấu việc làm với người dùng hoặc tắt lớp bảo vệ. Về quyền, Tara tìm tool xin quyền rộng hơn cần thiết và bypassPermissions. Về đích mạng, Tara liệt kê tên miền trong gói và cảnh báo dịch vụ nhận dữ liệu ẩn danh, link rút gọn, IP trần. Về dữ liệu nhạy cảm, Tara tìm số định danh, thẻ thanh toán, số điện thoại, email, tên miền nội bộ và IP riêng nằm trong nội dung. Cuối cùng, mọi lệnh shell trong tài nguyên được chấm bằng chính bộ luật Guardrails.
Tara không công bố chi tiết các mẫu. Nếu bạn bị cảnh báo mà nội dung hợp lệ, hãy giải thích trong README, chẳng hạn ở mục ## Permissions, để người đọc và người duyệt nắm được.
Quét mã độc
Bộ quét mã độc chạy trên gói, khớp là bài bị từ chối ngay. Nếu bản đã phát hành mà sau đó mới lộ mã độc, qua quét lại hoặc báo cáo từ người dùng, thì Tara gỡ gói và đưa vào danh sách thu hồi.
Người duyệt kho chính thức đọc những gì?
Chỉ kho chính thức có bước này. Người duyệt là nhân sự nền tảng PhillipCLI, dùng phiên đăng nhập trình duyệt chứ không dùng token cá nhân. Họ kiểm bảy điều.
- Tài nguyên làm đúng điều nó mô tả, không hơn.
- Họ đọc từng dòng script, hook, MCP và plugin chạy được, và đích mạng phải khớp mục đích.
- Quyền ở mức tối thiểu: tool giới hạn vừa đủ dùng, không đòi quyền thừa.
- Chỉ dẫn rõ ràng, không mâu thuẫn, không chứa dữ liệu nội bộ hay secret.
- Ràng buộc version của phụ thuộc hợp lý.
- Mức tăng version khớp với thay đổi, xem Quy tắc version.
- README, CHANGELOG và tài liệu đi kèm đủ để người khác cài và dùng.
Kết quả là duyệt, khi đó Tara ký rồi phát hành, hoặc trả lại kèm lý do. Nếu bị trả lại, bạn sửa, tăng version rồi gửi lại. Tác giả không tự duyệt bài của mình.
Gói policy Guardrails có gì thêm?
Gói policy phải qua thêm hai phép kiểm: cấu trúc file luật và cú pháp biểu thức. Kết quả ghi rõ policy chỉ siết thêm hay có nới. Xem Guardrails theo tầng.
Tài nguyên public bị giới hạn gì?
Tài nguyên public, mang nhãn Cộng đồng, chỉ được gồm Markdown và cấu hình. Tara từ chối kit, hooks, mcpServers, file chạy được và file nén khi bạn đăng với --visibility public hoặc đổi một tài nguyên sang public, và thêm bước chấm bằng model. Muốn chia sẻ kit hoặc mã chạy được, hãy để ở kho cá nhân, đóng góp cho tổ chức, hoặc gửi vào danh mục chính thức.
Ai cũng báo cáo được tài nguyên nghi vấn, và Tara quét lại ngay khi nhận báo cáo.
ph tara report ten-tai-nguyen --reason "Mô tả vấn đề"