Sáu loại tài nguyên
Tara chứa sáu loại tài nguyên, và năm loại trong đó là plugin theo chuẩn của Claude Code. Đọc trang này để biết việc mình định làm cần loại nào.
Sáu loại nhìn nhanh
| Loại | Tiền tố tên | Là gì | Thành phần chính |
|---|---|---|---|
| Skill | skill- | Kiến thức hoặc quy trình mà agent tự nạp khi cần | skills/<tên>/SKILL.md, script, mẫu |
| Agent | agent- | Agent con có vai trò riêng | agents/<tên>.md (prompt hệ thống, tool, model) |
| Prompt | prompt- | Lệnh do người dùng gọi | skills/<tên>/SKILL.md dạng lệnh |
| Kit | kit- | Kết nối hoặc tích hợp | .mcp.json, hooks/hooks.json, plugin cho Phillip, policy Guardrails |
| Harness | harness- | Môi trường làm việc trọn bộ của tổ chức hoặc dự án | dependencies tới tài nguyên khác, thư mục template/ |
| Model | alias | Hồ sơ model được phép dùng | Một mục trong catalog, không phải gói cài |
Xây trên chuẩn của Claude Code
Tara là một plugin marketplace theo chuẩn của Claude Code. Trừ model, mỗi tài nguyên có .claude-plugin/plugin.json nên Claude Code nhận chúng như mọi plugin khác. Slash command, agent con và skill hiện trong Claude Code như bình thường. Ràng buộc version giữa các tài nguyên dùng cú pháp dependencies chuẩn. Skill theo chuẩn mở Skills (SKILL.md) nên dùng lại được ngoài nền tảng. Ngoài ra bạn có thể tự kiểm tài nguyên bằng claude plugin validate, chính là lệnh Tara chạy khi nhận bài.
Dữ liệu riêng của nền tảng nằm trong khối metadata.forge của plugin.json, và Claude Code bỏ qua khối này. Các trường chi tiết có ở Định dạng tài nguyên.
Đặt tên tài nguyên
Tên có dạng <loại>-<tên>, viết kebab-case, dài tối đa 64 ký tự, ví dụ agent-reviewer. Tên cũng không được chứa các từ Anthropic dành riêng. Tên đầy đủ có thêm chủ: <chủ>/<tên>, ví dụ acme/skill-review hay an/skill-notes. Vì mỗi chủ có không gian tên riêng, hai chủ có thể cùng có skill-review mà không đụng nhau. Tên cũ có thêm một mã ở giữa, như agent-tta-java-review, vẫn hợp lệ.
Skill và prompt
Skill là một thư mục chứa SKILL.md với phần mô tả. Claude đọc mô tả, và khi việc đang làm khớp thì tự nạp skill. Prompt có cùng cấu trúc, nhưng bạn chủ động gọi bằng slash command, ví dụ /prompt-release-note:release-note.
Muốn truyền kiến thức hoặc quy trình cho agent thì chọn skill. Muốn có một lệnh có tên để tự gọi thì chọn prompt. Cách viết nằm ở Viết skill và agent.
Agent
Agent là một agent con theo vai trò, chẳng hạn phân tích yêu cầu, viết code, review hay kiểm thử. File agents/<tên>.md có phần đầu khai báo tên, mô tả và các tool được dùng, còn phần thân là chỉ dẫn hệ thống. Agent khai báo dependencies tới những skill nó cần.
Bạn nên giới hạn tool theo vai trò. Tool không giới hạn, như Bash mở hoàn toàn, sẽ bị Tara cảnh báo khi duyệt.
Kit
Kit là gói kết nối, và một kit có thể gộp nhiều dạng. Dạng máy chủ MCP khai báo trong .mcp.json, ví dụ để kết nối Knowledge base hay đưa công cụ GitHub, GitLab cho agent. Dạng hook khai báo trong hooks/hooks.json, ví dụ kiểm tra trước khi kết thúc lượt. Dạng plugin Phillip khai báo trong metadata.forge.phillip cho các nhà cung cấp scm, notify, tracker. Dạng policy Guardrails khai báo trong metadata.forge.guardrails, chứa luật an toàn của nền tảng, tổ chức hoặc dự án.
Kit không chứa credential
Kit không bao giờ chứa credential. Token do người dùng hoặc dịch vụ truyền vào lúc kết nối. Hợp đồng và cách kiểm nằm ở Viết kit.
Harness
Harness là bản phân phối: một gói tham chiếu tới agent, skill, prompt và kit theo ràng buộc version, kèm thư mục template/. Trong đó template/CLAUDE.md chứa quy ước của tổ chức bạn. Claude Code không nạp CLAUDE.md ở gốc plugin, nên ph init chèn nội dung này vào CLAUDE.md của dự án, trong một khối có đánh dấu. template/settings.json là cấu hình mặc định, được gộp vào .claude/settings.json mà vẫn giữ giá trị bạn đã đặt. Ngoài ra còn các tệp mẫu khác như .bandum.json.
Cài một harness là có trọn môi trường.
ph init harness-rnd-sdlcChạy lại lệnh chỉ thay nội dung trong khối do Phillip quản lý, còn phần bạn tự viết ngoài khối được giữ nguyên. Cách viết harness nằm ở Viết harness.
Model
Model không phải gói cài. Nó là một mục trong catalog của Tara gồm alias, tên model thật, mục đích và vai trò phù hợp. Có ba mục đích: reasoning cho suy luận, thiết kế và review, code cho sinh code và phân tích hằng ngày, light cho việc nhanh và đơn giản.
Mỗi mục đích có một model gợi ý. Lệnh ph model use <alias> ghi model vào .claude/settings.json của dự án. Model deprecated vẫn hiện nhưng bạn không nên chọn mới. Xem thêm Chọn model.
Ai sở hữu tài nguyên: bạn, tổ chức hay PhillipCLI
Mỗi tài nguyên có một chủ, giống repo trên GitHub. Tên đầy đủ là <chủ>/<tên>.
| Chủ | Ví dụ | Phạm vi | Ai thấy và cài được |
|---|---|---|---|
| Bạn (kho cá nhân) | an/skill-notes | private (mặc định) hoặc public | Chỉ bạn, ở mọi tổ chức bạn tham gia |
| Một tổ chức | acme/skill-notes | internal (mặc định) hoặc public | Mọi thành viên của tổ chức, kể cả Viewer |
| PhillipCLI | aiforge/skill-review | luôn public (chính thức) | Mọi người |
Tài nguyên public của người hay tổ chức mang nhãn Cộng đồng, mọi người dùng PhillipCLI đều thấy. Tên người dùng và slug tổ chức dùng chung một không gian tên, nên an/ không thể vừa là người vừa là tổ chức. Tạo tổ chức có slug trùng tên một người sẽ bị từ chối, còn người dùng mới có tên trùng slug một tổ chức thì được thêm hậu tố, ví dụ an-2.
Từ cá nhân tới tổ chức rồi công khai
Tài nguyên đi ra ngoài qua ba bước, không bước nào cần người duyệt.
- Cá nhân. Đăng vào kho của chính bạn để tự thử. Đây là mặc định của
ph tara publish. - Đóng góp cho tổ chức. Chép sang
<org>/<tên>bằngph tara contribute <tên> --org <org>, hoặc đăng thẳng vào tổ chức bằng--org. Bản chép ghi người đóng góp và nguồn gốc, được phát hành ngay và ký số cho tổ chức. Cài đặt Ai được đăng vào tổ chức quyết định Member hay chỉ Admin làm được việc này. Viewer thì không bao giờ. - Công khai. Đổi phạm vi sang
public. Áp luật cộng đồng: không có thành phần chạy được, có quét mã độc, secret và bước chấm bằng model. Với tài nguyên của tổ chức, chỉ Owner hoặc Admin làm được. Tài nguyên public không đóng lại được khi còn tài nguyên public khác phụ thuộc vào nó hoặc một lock của project đang khóa nó.
Ở mọi bước đều có bộ quét tự động (mã độc, secret, prompt injection), chữ ký số và khóa version, và version được phát hành ngay khi bộ quét không chặn. Tài nguyên cá nhân và của tổ chức được chứa thành phần chạy được như hook, script, MCP server, nên hãy đọc kỹ thứ bạn cài. Tài nguyên public thì không được.
Chỉ kho chính thức aiforge/<tên> có bước duyệt, do nhân sự nền tảng PhillipCLI duyệt từng version.
Cách giải tên
Tên trần như skill-review được tìm theo thứ tự: aiforge/ trước, rồi tổ chức đang dùng, rồi kho cá nhân của chính bạn. Tên trần không bao giờ khớp tài nguyên của người hay tổ chức khác, nên không ai chiếm được tên bằng cách đăng một tài nguyên public trùng tên. Nếu không khớp gì mà nơi khác có tài nguyên public cùng tên, Tara trả 404 kèm gợi ý các tên đầy đủ, ví dụ did you mean beta/skill-foo?. Tên trần trong dependencies của một gói được giải theo aiforge/ rồi tới chủ của chính gói đó.
Trong plugin.json, metadata.forge.org là chủ đích: aiforge hoặc slug tổ chức. Không khai báo thì tài nguyên vào kho cá nhân của bạn. Tùy chọn --org của ph tara publish ghi đè giá trị này. Kênh phát hành xuất hiện trong chữ ký là official, org, user hoặc community. Xem Khóa version và chữ ký số.
Mỗi version có một trạng thái trong vòng đời, từ đang kiểm, đã phát hành cho tới ngừng hỗ trợ và thu hồi (trạng thái chờ duyệt chỉ có ở kho chính thức). Phillip hỏi xác nhận trước khi cài tài nguyên community vào dự án. Muốn cấm hẳn thì đặt PHILLIP_TARA_COMMUNITY=deny.