Bắt đầu cho người đóng góp
Bạn có một ý tưởng cho skill, agent hay prompt, và muốn nó được ký số, phát hành rồi xuất hiện trên Tara. Trang này đi qua cả chặng đó bằng dòng lệnh ph tara. Trước hết bạn cần cài Phillip và đăng nhập Tara bằng ph tara login. Nếu chưa cài thì xem Cài đặt chi tiết.
Portal Tara cũng có trình hướng dẫn tạo tài nguyên, trình soạn version mới và chỗ tải gói lên. Bạn vào mục Contribute (đóng góp), bấm Create resource (tạo tài nguyên), rồi chọn Use the wizard (dùng trình hướng dẫn) hoặc Upload a package (tải gói lên). Cũng ở mục này bạn theo dõi các bài mình đã gửi, giống lệnh ph tara submissions. Ở trình hướng dẫn và trang tải gói, bạn chọn chủ (chính bạn hoặc một tổ chức) và phạm vi. Hai cách này đi qua cùng chuỗi kiểm tra tự động, nên bạn chọn cách nào tiện hơn cũng được.
Chọn loại tài nguyên và nơi đăng
Tara có các loại tài nguyên skill, agent, kit, prompt và harness, xem Sáu loại tài nguyên. Mỗi tài nguyên có một chủ, và bạn chọn chủ khi đăng: kho cá nhân của bạn, một tổ chức bạn tham gia, hoặc (với nhân sự nền tảng) kho chính thức.
| Cá nhân | Của tổ chức | Chính thức | |
|---|---|---|---|
| Tên đầy đủ | <handle-của-bạn>/<tên>, ví dụ an/skill-notes | <org>/<tên>, ví dụ acme/skill-notes | aiforge/<tên> |
| Ai đăng | Chính bạn | Mặc định Owner, Admin và Member; nếu tổ chức đặt "Chỉ quản trị" thì chỉ Owner và Admin. Viewer không bao giờ | Nhân sự nền tảng |
| Cách chọn | Mặc định, hoặc manifest không có org | ph tara publish --org <slug>, hoặc metadata.forge.org: <slug> | metadata.forge.org: aiforge |
| Phạm vi | private (mặc định) hoặc public | internal (mặc định) hoặc public | Luôn public |
| Duyệt | Không, bộ quét tự động quyết định | Không, bộ quét tự động quyết định | Nhân sự nền tảng duyệt từng version |
| Nội dung | Được kèm script, hook, MCP (public: chỉ Markdown và cấu hình) | Như vậy | Được kèm script, hook, MCP |
Đường đi là cá nhân, rồi tổ chức, rồi công khai. Bạn thử tài nguyên ở kho cá nhân, chia sẻ cho nhóm bằng ph tara contribute <tên> --org <slug> (lệnh chép tài nguyên và ghi người đóng góp cùng nguồn gốc), và mở công khai bằng ph tara visibility <tên> public khi đã sẵn sàng cho mọi người. Tên trần nghĩa là aiforge/<tên>, rồi tổ chức đang dùng, rồi kho của chính bạn.
Dùng ph tara new --org <tổ-chức-của-bạn> để tạo tài nguyên cho tổ chức, hoặc bỏ --org để tạo ở kho cá nhân. Nếu bạn không đăng được vào tổ chức, có thể Owner hoặc Admin đã giới hạn việc đăng cho quản trị ở Cài đặt, mục Chung. Bạn vẫn đăng được vào kho cá nhân rồi nhờ một Admin đóng góp.
Từ ý tưởng đến tài nguyên đã phát hành
Vuốt ngang để xem hết sơ đồ.
Tạo tài nguyên từ mẫu. Tên có dạng
<loại>-<tên>; chủ được chọn lúc đăng, không nằm trong tên:bashph tara new agent agent-java-review --description "Review code Java theo quy ước của chúng tôi"Lệnh tạo một thư mục có
plugin.json,README.md,CHANGELOG.mdvà khung theo loại. Thêm--org <slug>để ghi tổ chức vào manifest, hoặc bỏ đi để tạo ở kho cá nhân.Sửa nội dung: viết agent hoặc skill, cập nhật
README.mdvà thêm mụcCHANGELOG.mdcho version sắp gửi. Cách viết có trong Viết skill và agent.Kiểm tra trước khi gửi. Lệnh này chạy cùng chuỗi luật mà Tara dùng và không lưu gì:
bashph tara check ./agent-java-reviewBạn sửa mọi dòng báo lỗi. Cảnh báo không chặn, nhưng bạn nên đọc. Các luật chính gồm tên, manifest, cấu trúc theo loại, tài liệu, phụ thuộc và quét bí mật.
Đăng lên Tara. Không thêm tùy chọn thì tài nguyên vào kho cá nhân; dùng
--org <slug>cho tổ chức và--visibilityđể chọn phạm vi của tài nguyên mới:bashph tara publish ./agent-java-reviewTara quét gói và phát hành ngay nếu không có gì chặn: không có hàng đợi duyệt, trừ kho chính thức. Tài nguyên cá nhân mới bắt đầu ở
private, còn của tổ chức ởinternal.Theo dõi bài gửi:
bashph tara submissions # bài gửi của bạn và trạng thái ph tara status agent-java-review@1.0.0 # kết quả kiểm tra, lý do trả lạiKhi cần sửa, bạn lấy mã nguồn về, tăng version rồi gửi lại. Version đã gửi là bất biến nên mỗi lần sửa phải là một version mới:
bashph tara pull agent-java-review@1.0.0 --dir ./agent-java-review ph tara bump ./agent-java-review 1.0.1 --changelog "Sửa theo góp ý" ph tara check ./agent-java-review ph tara publish ./agent-java-review
Cách đặt số version nằm ở Quy tắc version.
Bài gửi đang ở trạng thái nào?
| Trạng thái trên CLI | Nghĩa là | Bạn làm gì |
|---|---|---|
submitted, checking | Tara đã nhận gói và đang chạy chuỗi luật tự động | Chờ vài giây đến vài phút |
checks failed | Có luật mức lỗi không đạt | Đọc ph tara status, sửa rồi gửi version mới |
awaiting review, changes requested | Chỉ ở kho chính thức: đang chờ, hoặc bị nhân sự nền tảng trả lại | Chờ, hoặc sửa theo lý do rồi gửi version mới |
published | Đã qua kiểm tra, ký số và hiện với người xem được tài nguyên | Không cần làm gì thêm |
deprecated, yanked | Version không còn được khuyến nghị hoặc đã bị thu hồi | Gửi version sửa lỗi nếu cần |
Các phép kiểm được mô tả ở Tiêu chí duyệt.
Vai trò và ký số
Vai trò thuộc về tổ chức. Admin hoặc Owner đổi vai trò ở mục Admin (quản trị) trên Portal, hoặc bằng ph org members set-role <login> <owner|admin|member|viewer>, và đặt ai được đăng vào tổ chức ở Cài đặt, mục Chung. Tài nguyên chính thức (aiforge/<tên>) do nhân sự nền tảng PhillipCLI đăng và duyệt; việc duyệt cần phiên đăng nhập bằng trình duyệt, còn token cá nhân không duyệt được.
Khi một version được phát hành, Tara ký số bản khai của nó gồm tên, version, sha256, chủ, kênh (official, org, user hoặc community) và thời điểm phát hành. Mỗi lần cài, Phillip kiểm chữ ký này, nên gói bị sửa sau khi phát hành sẽ bị từ chối. Nếu một bản có vấn đề nghiêm trọng, nó bị thu hồi (yank) và Tara ký lại danh sách thu hồi. Chi tiết ở Khóa version và chữ ký số.
Tài nguyên cá nhân thì bạn đổi phạm vi bằng ph tara visibility <tên> public|private và tự thu hồi bản lỗi bằng ph tara yank. Với tài nguyên của tổ chức, Owner hoặc Admin làm việc đó. Còn người khác nghi ngờ một tài nguyên có vấn đề thì dùng ph tara report, và Tara sẽ quét lại ngay.