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

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.

Bước 1 của trình hướng dẫn: loại, chủ sở hữu và chế độ hiển thị.

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ânCủa tổ chứcChí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-notesaiforge/<tên>
Ai đăngChính bạnMặ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ọnMặc định, hoặc manifest không có orgph tara publish --org <slug>, hoặc metadata.forge.org: <slug>metadata.forge.org: aiforge
Phạm viprivate (mặc định) hoặc publicinternal (mặc định) hoặc publicLuôn public
DuyệtKhông, bộ quét tự động quyết địnhKhông, bộ quét tự động quyết địnhNhâ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.

Sau khi phát hành, tài nguyên có trang riêng với tài liệu, lệnh cài và lượt tải.

Từ ý tưởng đến tài nguyên đã phát hành ​

Đường đi của một tài nguyên khi đóng góp. Trên máy bạn: ph tara new tạo từ mẫu, ph tara check kiểm tra, ph tara publish gửi lên Tara. Trên Tara: kiểm tự động, duyệt, Tara ký, rồi phát hành bất biến. Nếu cần sửa, người duyệt yêu cầu sửa và bạn quay lại bước kiểm tra với version mới.Trên máy bạnTạo từ mẫuph tara newKiểm traph tara checkGửi lên Taraph tara publishTrên TaraKiểm tự độngsecret, manifest,mã chạy được,quét mã độcNgười duyệtđọc góirồi bấm DuyệtTara kýkhóa Ed25519,cùng lúc duyệtPhát hànhversion bất biến,có chữ kývào hàng đợiYêu cầu sửa

Vuốt ngang để xem hết sơ đồ.

Cần sửa thì bạn lấy gói về bằng ph tara pull, tăng version bằng ph tara bump rồi kiểm tra và gửi lại. Version đã gửi không bao giờ đổi.
  1. 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:

    bash
    ph 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.md và 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.

  2. Sửa nội dung: viết agent hoặc skill, cập nhật README.md và thêm mục CHANGELOG.md cho version sắp gửi. Cách viết có trong Viết skill và agent.

  3. 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ì:

    bash
    ph tara check ./agent-java-review

    Bạ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.

  4. Đă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:

    bash
    ph tara publish ./agent-java-review

    Tara 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.

  5. Theo dõi bài gửi:

    bash
    ph 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ại
  6. Khi 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:

    bash
    ph 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 CLINghĩa làBạn làm gì
submitted, checkingTara đã nhận gói và đang chạy chuỗi luật tự độngChờ vài giây đến vài phút
checks failedCó 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 requestedChỉ ở kho chính thức: đang chờ, hoặc bị nhân sự nền tảng trả lạiChờ, 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ênKhông cần làm gì thêm
deprecated, yankedVersion không còn được khuyến nghị hoặc đã bị thu hồiGử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.

Đọc thêm ​