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

Định dạng tài nguyên ​

Trang này tả plugin.json của mọi tài nguyên trên Tara, khối metadata.forge, cấu trúc gói theo từng loại và catalog model. Muốn làm từng bước thì xem Viết skill và agent.

plugin.json ​

File nằm ở .claude-plugin/plugin.json. Các trường theo chuẩn plugin của Claude Code, cộng thêm quy tắc riêng của Tara.

TrườngBắt buộcMô tả
nameCóTên tài nguyên, xem quy tắc đặt tên
versionCóSemver MAJOR.MINOR.PATCH
descriptionCóMô tả ngắn, không rỗng
author.nameCóTên tác giả hoặc nhóm
displayNameKhôngTên hiển thị
licenseKhôngGiấy phép
keywordsKhôngTừ khóa tìm kiếm
dependenciesHarness: cóDanh sách phụ thuộc, xem mục dưới
hooks, mcpServersKhôngKhai báo trực tiếp. Thường đặt trong hooks/hooks.json và .mcp.json
metadata.forgeCóDữ liệu riêng của nền tảng

Claude Code coi version, description và author.name là tùy chọn, nhưng Tara bắt buộc cả ba.

dependencies ​

Mỗi mục là một object { "name", "version" } hoặc chuỗi "tên". Bạn chỉ phụ thuộc được vào tài nguyên có trên Tara, không trỏ sang marketplace khác. Tài nguyên chính thức cũng chỉ phụ thuộc tài nguyên chính thức.

json
"dependencies": [
  { "name": "agent-dev", "version": "~1.1.0" },
  { "name": "skill-sdlc", "version": "^1.2.0" }
]

Ràng buộc version viết được theo các kiểu ^1.2, ~1.2.0, =1.2.0 (hoặc 1.2.0), >=1.0 <2.0 và ^1.0 || ^2.0. Thiếu ràng buộc thì Tara cảnh báo. Cách Tara khóa version nằm ở Khóa version và chữ ký số.

metadata.forge ​

Claude Code bỏ qua khối này, chỉ Tara và Phillip đọc.

TrườngBắt buộcKiểuMô tả
schemaCósốPhiên bản định dạng, hiện là 1
typeCóchuỗiskill, agent, kit, prompt hoặc harness
orgTài nguyên chính thức và của tổ chứcchuỗiKhông gian tên của kho: aiforge cho danh mục chính thức, hoặc slug tổ chức của bạn cho kho riêng của tổ chức. Bỏ trống thì đây là tài nguyên cộng đồng, nằm trong không gian tên của người gửi
centerKhôngchuỗiĐã bỏ, thay bằng org. Vẫn được đọc kèm cảnh báo: rnd tính là aiforge, giá trị khác tính là tổ chức của người gửi
ownersCómảng emailNgười chịu trách nhiệm bảo trì, ít nhất một
rolesKhôngmảng chuỗiVai trò nghề nghiệp phù hợp, gồm PO, BA, UIUX, SA, PM, Dev, Reviewer, Test, Security, DevOps, Docs, Builder
enginesCómảng chuỗiclaude-code, hoặc phillip (chỉ dành cho kit plugin của Phillip)
statusCóchuỗiactive hoặc deprecated
replacedByKhôngchuỗiTên tài nguyên thay thế khi deprecated
modelKhôngchuỗiAlias model mặc định cho harness, phải có trong catalog
docsKhông*mảngTài liệu đi kèm, xem mục dưới. *Kit và harness bắt buộc có install và usage
phillipKit pluginobjectKhai báo plugin cho Phillip
guardrailsKit policyobjectKhai báo gói policy Guardrails

roles chỉ giúp tìm kiếm và gợi ý, không cấp quyền.

docs ​

json
"docs": [
  { "type": "install", "path": "docs/cai-dat.md", "title": "Hướng dẫn cài đặt" },
  { "type": "usage", "path": "docs/su-dung.pdf" }
]
TrườngMô tả
typeinstall, usage, configuration, troubleshooting hoặc other
pathĐường dẫn trong gói
titleTiêu đề hiển thị; bỏ trống thì dùng tên loại

Hiện Tara nhận md (tối đa 2 MB) và pdf (tối đa 20 MB, có kiểm chữ ký đầu file). Loại và định dạng là cấu hình của Tara nên có thể khác ở tổ chức của bạn, gọi GET /v1/document-policy để xem. Tài liệu tách khỏi gói cài, lưu theo version, không sửa được và nằm trong chữ ký số. Muốn đọc thì chạy ph tara docs <tên>.

phillip ​

Khối này dành cho kit có engines: ["phillip"]. Hợp đồng chi tiết nằm ở Hợp đồng plugin.

TrườngBắt buộcMô tả
providesCóscm, notify hoặc tracker
apiCóPhiên bản hợp đồng, hiện là 1
entryCóĐường dẫn module ESM trong gói
capabilitiesKhôngscm có task, report, sync (bỏ trống là task); notify có send; tracker có task
matchesscmHost của remote origin mà kit phục vụ. notify và tracker không dùng trường này
credential.labelCóTên credential hiển thị cho người dùng
credential.help, url, env, optionalKhôngHướng dẫn, trang tạo token, biến môi trường gợi ý, và cho phép chạy không cần bí mật
settings.<tên>Khôngdefault, env, required, help. Kit tracker bắt buộc có settings.project với required: true

guardrails ​

TrườngGiá trị
schema1
levelcompany hoặc project
policyĐường dẫn file luật trong gói

Quy tắc đặt tên ​

text
<loại>-<tên>

Tên viết theo kebab-case, dài tối đa 64 ký tự và bắt đầu bằng tiền tố loại: skill-, agent-, kit-, prompt- hoặc harness-. Tên không chứa từ claude hay anthropic, cũng không dùng từ dành riêng của nền tảng (tên các thành phần, official). Tên cũ có thêm một mã ở giữa, như agent-tta-java-review, vẫn hợp lệ, nhưng tên mới không cần mã này.

Không gian tên không nằm trong tên. Tên đầy đủ là <org>/<tên>, theo kiểu npm scope, ví dụ acme/skill-review. Tên trần như skill-review nghĩa là aiforge/skill-review. Khi gặp tên trần, Tara chỉ tìm trong aiforge, rồi đến tổ chức của người gọi, không bao giờ sang tổ chức khác. Nhờ vậy không ai chiếm được tên trần bằng một tài nguyên cộng đồng của riêng mình. Tài nguyên cộng đồng của tổ chức khác phải gọi bằng tên đầy đủ; nếu tên trần không khớp mà có tên như vậy, Tara trả 404 kèm gợi ý, ví dụ did you mean beta/skill-foo?. Phụ thuộc là tên trần trong manifest của một gói được tìm trong aiforge, rồi đến tổ chức của chính gói đó. Muốn phụ thuộc vào tài nguyên của tổ chức khác, ghi tên đầy đủ.

Kênh ​

Kênh của tài nguyên do metadata.forge.org quyết định.

org trong manifestKênhAi duyệtNội dung
aiforgeofficialNhân sự nền tảngCó thể kèm script, hook, MCP
Slug tổ chức của người gửiorg (kho riêng của tổ chức)Admin hoặc Owner của tổ chứcCó thể kèm script, hook, MCP
Bỏ trốngcommunityKhông có người duyệt, bộ quét tự động quyết địnhChỉ Markdown và cấu hình, bắt đầu ở chế độ private

Tài nguyên cộng đồng nằm trong không gian tên của chính người gửi. Trường center cũ vẫn được đọc: rnd thành aiforge, giá trị khác thành tổ chức của người gửi, và Tara thêm một phát hiện báo trường này đã bỏ.

Cấu trúc theo loại ​

LoạiBắt buộc thêm
Mọi loạiREADME.md, CHANGELOG.md có mục ## <version>; không có CLAUDE.md ở gốc
agentÍt nhất một agents/<tên>.md
skill, promptÍt nhất một skills/<tên>/SKILL.md
kitÍt nhất một: .mcp.json, hooks/hooks.json, metadata.forge.phillip, metadata.forge.guardrails
harnesstemplate/CLAUDE.md và dependencies

Catalog model ​

Model không phải gói cài, nó là một mục trong catalog gồm các trường sau.

TrườngMô tả
aliasTên ngắn kebab-case, ví dụ sonnet-std
engineEngine, ví dụ claude-code
modelĐịnh danh model gửi cho engine
taskreasoning, code hoặc light
purposeMô tả ngắn công dụng
rolesVai trò nghề nghiệp phù hợp
statusactive (chọn mới được) hoặc deprecated (đang rút dần)
recommendedModel được gợi ý mặc định cho task. Model deprecated không thể là gợi ý

Muốn chọn model cho dự án thì chạy ph model use <alias>.

Đọc thêm ​