Bỏ qua, đến phần nội dung

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ạiTiền tố tênLà gìThành phần chính
Skillskill-Kiến thức hoặc quy trình mà agent tự nạp khi cầnskills/<tên>/SKILL.md, script, mẫu
Agentagent-Agent con có vai trò riêngagents/<tên>.md (prompt hệ thống, tool, model)
Promptprompt-Lệnh do người dùng gọiskills/<tên>/SKILL.md dạng lệnh
Kitkit-Kết nối hoặc tích hợp.mcp.json, hooks/hooks.json, plugin cho Phillip, policy Guardrails
Harnessharness-Môi trường làm việc trọn bộ của tổ chức hoặc dự ándependencies tới tài nguyên khác, thư mục template/
ModelaliasHồ sơ model được phép dùngMộ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.

bash
ph init harness-rnd-sdlc

Chạ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 viAi thấy và cài được
Bạn (kho cá nhân)an/skill-notesprivate (mặc định) hoặc publicChỉ bạn, ở mọi tổ chức bạn tham gia
Một tổ chứcacme/skill-notesinternal (mặc định) hoặc publicMọi thành viên của tổ chức, kể cả Viewer
PhillipCLIaiforge/skill-reviewluô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.

  1. 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.
  2. Đóng góp cho tổ chức. Chép sang <org>/<tên> bằng ph 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ờ.
  3. 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.

Đọc thêm ​