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

Câu hỏi thường gặp ​

Đây là những câu hỏi người mới dùng hay gặp nhất. Nếu bạn đang gặp một thông báo lỗi cụ thể thì xem Xử lý sự cố.

Cài đặt ​

Tôi cần cài gì để bắt đầu? ​

Dev và Test cần Node 22 trở lên, git và Phillip, cài từ Tara bằng một lệnh. BA, PO, PM chỉ cần trình duyệt. Xem Dev và Test và Bắt đầu cho BA, PO, PM.

Cài xong mà gõ ph thì báo command not found? ​

Thư mục bin toàn cục của npm chưa nằm trong PATH. Bạn mở terminal mới, nếu vẫn lỗi thì thêm $(npm prefix -g)/bin vào PATH. Trong lúc chờ, bạn có thể gõ phillip thay cho ph. Xem Cài đặt chi tiết.

Tôi có phải dùng sudo để cài không? ​

Không, script cài không dùng sudo. Nếu gặp lỗi EACCES, bạn đặt prefix npm vào thư mục của mình theo hướng dẫn ở Cài đặt chi tiết. Riêng Guardrails thì cài bằng quyền quản trị.

Làm sao cập nhật Phillip? ​

Bạn chạy lại đúng lệnh cài. Script lấy bản mới nhất từ Tara, kiểm sha256, cài đè và giữ nguyên cấu hình của bạn.

Tài khoản ​

Tôi đăng nhập Tara bằng tài khoản nào? ​

Hiện tại bạn dùng GitHub. GitLab và SSO xuất hiện khi tổ chức của bạn cài đặt. Đăng nhập chỉ cho biết bạn là ai, chứ không đưa bạn vào tổ chức nào. Vì vậy tài khoản mới sẽ thấy màn hình Get started (Bắt đầu), ở đó bạn tạo tổ chức hoặc nhận lời mời. Tara không lưu mật khẩu. Web Bandum đăng nhập qua Tara nên cũng không có mật khẩu riêng.

Tôi đăng nhập được nhưng không thấy dự án nào? ​

Mục Projects (dự án) chỉ hiện các dự án của tổ chức bạn đang mở. Bạn kiểm tra bộ chuyển tổ chức ở đầu Portal, vì có thể bạn thuộc nhiều tổ chức. Nếu bạn chưa thuộc tổ chức nào, bạn sẽ thấy màn hình Get started. Nếu đúng tổ chức rồi, hãy hỏi Owner hoặc Admin xem dự án đã có chưa. Member tự tạo được bằng ph project create <key>.

Tổ chức và seat ​

Tổ chức là gì? ​

Đó là không gian của công ty hay nhóm bạn trong PhillipCLI. Nó chứa thành viên, dự án, kho tài nguyên riêng, guardrails và số liệu, và tổ chức khác không thấy gì trong đó. Trong một tổ chức, công việc được chia theo dự án. Xem Vai trò và quyền.

Làm sao để vào một tổ chức? ​

Bạn nhờ Owner hoặc Admin mời. Lời mời đến qua email hoặc dưới dạng một đường dẫn: bạn mở ra, đăng nhập là vào. Trên Portal, Owner và Admin dùng trang thành viên của tổ chức. Với Phillip, họ chạy ph org invite <email> --role member, hoặc ph org invite --link để lấy đường dẫn. Nếu chưa có lời mời, bạn tự tạo tổ chức của mình từ màn hình Get started hoặc bằng ph org create <slug>.

Tôi có thể thuộc nhiều tổ chức không? ​

Được, giống như trên GitHub. Mỗi tổ chức bạn có một vai trò riêng. Bộ chuyển tổ chức ở đầu Portal đổi tổ chức bạn đang xem, còn trong terminal thì dùng ph org list và ph org switch <slug>. Một lần đăng nhập và một token thuộc về một tổ chức, nên sau khi chuyển, Phillip dùng token của tổ chức đó.

Seat là gì? Tôi có bao nhiêu seat? ​

Owner, Admin và Member dùng một seat. Viewer không dùng seat và miễn phí. Gói Free có 7 seat. Gói Team không giới hạn seat, giá 3 USD mỗi người dùng AI mỗi tháng hoặc 30 USD mỗi năm, tính tối thiểu 8 người; xem Bảng giá và Thanh toán và nâng gói. Khi hết seat, việc mời hoặc vào thêm Owner, Admin, Member bị từ chối với mã seat_limit. Xem Xử lý sự cố. Lệnh ph org current cho biết gói và số seat.

Viewer là ai? ​

Viewer chỉ làm việc trên trình duyệt: xem task, nghiệm thu trên Bandum web và đọc dashboard. Đây là vai trò hợp với BA, PO, PM. Viewer không chạy agent và không cài tài nguyên.

Tôi gõ skill-review hay acme/skill-review? ​

Tên đầy đủ có dạng <chủ>/<tên>, ví dụ acme/skill-review hay an/skill-notes. Tên trần như skill-review được hiểu là aiforge/skill-review trước, rồi đến tài nguyên của tổ chức đang dùng, rồi đến kho cá nhân của chính bạn. Nó không bao giờ khớp với tài nguyên của người hay tổ chức khác, nên không ai chiếm được một tên trần bằng cách đăng một tài nguyên công khai. Muốn dùng tài nguyên của người khác, bạn gõ tên đầy đủ. Xem Tài nguyên.

Vì sao tên trần của tôi không ra kết quả? ​

Tên trần chỉ tìm trong aiforge/, tổ chức đang dùng và kho cá nhân của bạn. Nếu tài nguyên thuộc người khác, hoặc thuộc một tổ chức bạn chưa mở, Tara trả 404 và, khi có tài nguyên public cùng tên, kèm gợi ý như did you mean beta/skill-foo?. Bạn dùng tên đầy đủ trong gợi ý. Nếu đó là tài nguyên cá nhân của chính bạn mà vẫn lỗi, hãy kiểm tra bạn đang đăng nhập đúng tài khoản chủ (ph tara whoami in ra không gian tên của bạn).

Kho cá nhân là gì? ​

Tài khoản nào cũng có một kho. Tài nguyên bạn đăng bằng ph tara publish vào đó theo mặc định, tên <handle-của-bạn>/<tên>, và chỉ bạn thấy và cài được, ở mọi tổ chức bạn tham gia. Đây là chỗ để thử. Ở đó được dùng script, hook và MCP server, nhưng tài nguyên public thì không được chứa chúng.

Làm sao chia sẻ tài nguyên cho nhóm? ​

Hãy đóng góp: ph tara contribute <tên> --org <slug> chép tài nguyên sang <org>/<tên>, ghi người đóng góp và nguồn gốc, rồi phát hành ngay cho mọi thành viên của tổ chức. Không có bước duyệt. Bạn cũng đăng thẳng vào tổ chức được bằng ph tara publish --org <slug>. Tài nguyên của tổ chức mặc định là internal.

Ai được đăng vào tổ chức của tôi? ​

Owner và Admin luôn được, còn Member được theo mặc định. Owner hoặc Admin đổi điều này ở Cài đặt, mục Chung, phần Ai được đăng vào tổ chức: Thành viên và quản trị hoặc Chỉ quản trị. Viewer không bao giờ đăng vào tổ chức, nhưng vẫn dùng được kho cá nhân của mình. Thay đổi được ghi vào nhật ký audit.

Tôi có mở public một tài nguyên được không? ​

Được, bằng ph tara visibility <tên> public, hoặc ngay trên trang tài nguyên. Tài nguyên cá nhân do chủ của nó mở public, tài nguyên của tổ chức do Owner hoặc Admin mở. Áp luật cộng đồng: không có thành phần chạy được, có quét mã độc và secret, và có bước chấm bằng model. Nếu Tara từ chối thì nó nói bạn cần sửa gì. Tài nguyên public mang nhãn Cộng đồng, ai cũng cài được bằng tên đầy đủ.

Một tổ chức và một người có đặt trùng tên được không? ​

Không. Người dùng và tổ chức dùng chung một không gian tên. Tara từ chối tạo tổ chức có slug trùng tên một người, và 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.

Platform staff là ai? ​

Là một nhóm nhỏ của PhillipCLI, vận hành dịch vụ và duyệt kho chính thức (aiforge/<tên>). Đây là cờ nội bộ trên tài khoản PhillipCLI của họ, không phải vai trò bạn được cấp trong tổ chức. Tài nguyên của chính tổ chức bạn không có bước duyệt: version qua bộ quét tự động là được phát hành ngay.

Phiên đăng nhập hết hạn thì làm sao? ​

Bạn chạy ph login để đăng nhập lại (--org <slug> để chọn tổ chức), và ph tara whoami để xem tài khoản cùng hạn phiên. Máy không có trình duyệt, như qua SSH hay trong CI, thì dùng ph tara login --token-stdin với token cá nhân.

Đó là thông báo từ PhillipCLI: bảo trì theo lịch, sự cố hoặc tin mới. Thông báo nhắm tới tổ chức của bạn (mọi tổ chức, một gói hoặc một số tổ chức cụ thể), có biểu tượng và nhãn (Info, Warning hay Critical). Có thông báo cho phép tắt bằng nút X; tắt rồi thì chỉ bạn không thấy nữa. Thông báo cần bạn chú ý cũng có thể được gửi qua email tới owner của tổ chức.

Trong CLI có thấy thông báo không? ​

Có. ph tara announcements liệt kê các thông báo đang hiệu lực của tổ chức hiện tại. Các lệnh ph tara ... khác mỗi ngày in một lần thông báo warning hoặc critical đang hiệu lực (ra stderr, nên script và đầu ra --json không bị ảnh hưởng). Đặt PHILLIP_NO_ANNOUNCEMENTS=1 nếu muốn tắt.

Tôi nhận được email nói đội hỗ trợ PhillipCLI đã xem tài khoản của tôi. Chuyện gì xảy ra? ​

Một kỹ sư hỗ trợ đã mở chế độ xem chỉ đọc tài khoản hoặc tổ chức của bạn, tối đa 30 phút, để xử lý một yêu cầu. Trong lúc xem không thể đổi gì: mọi thao tác ghi đều bị từ chối. Bạn và owner của tổ chức nhận email khi lượt xem bắt đầu, và lượt xem hiện trong nhật ký audit của tổ chức mà không nêu tên người xem.

Task và kiểm thử ​

Mã GH-12 nghĩa là gì? Trên GitLab có dùng không? ​

Đó là số của issue. Trên GitLab bạn vẫn dùng tiền tố GH- với số issue trong project.

Sao tôi không bấm được nút Approve? ​

Approve (duyệt) chỉ bấm được khi mọi testcase đã chấm là Pass. Nếu còn testcase chưa chấm, hoặc có testcase Fail mà chưa mô tả lỗi thì nút chưa dùng được. Khi có testcase không đạt, bạn bấm Send back (trả lại). Người mở PR cũng không tự duyệt PR của mình.

Bug nằm ngay trong task đang kiểm thử thì báo thế nào? ​

Bạn chấm testcase liên quan là Fail (không đạt) và mô tả lỗi, đừng tạo issue mới. Chỉ lỗi ngoài phạm vi task mới cần issue type: bug. Xem Báo bug.

Task bị trả lại thì làm gì? ​

Bạn chạy ph bandum pull GH-12 để xem nhận xét, ph bandum fix GH-12 để giao agent sửa, rồi ph bandum verify và ph bandum review để chuyển kiểm thử lại. Xem Vòng đời một task.

Vì sao ph bandum review từ chối chuyển kiểm thử? ​

Thường là do còn AC chưa có testcase, hoặc testcases.md còn mục chưa điền (<fill in the name>). Bạn chạy ph bandum check để thấy từng lỗi. Mỗi AC của task phải có ít nhất một testcase.

Dữ liệu và quyền riêng tư ​

Mã nguồn của tôi có bị gửi lên Tara không? ​

Không. Phillip và Bandum chạy trên máy bạn nên mã nguồn ở lại máy bạn. Tara và Ryoma chạy online và chỉ nhận số liệu sử dụng, không nhận mã nguồn. Chi tiết ở Dữ liệu thu thập.

Số liệu của tôi có dùng để đánh giá cá nhân không? ​

Không. Các chỉ số Flow và AI là của dự án và luồng việc. Số liệu từng người chỉ chính người đó xem được, Owner và Admin cũng xem mức dùng và hạn mức để quản lý. Member và Viewer không thấy số liệu của người khác. Xem Ai xem được gì.

Guardrails chặn một thao tác hợp lý thì tôi làm gì? ​

Bạn đọc lý do trong thông báo và nhờ agent làm theo cách khác. Nếu thấy chặn nhầm, hãy gửi ph guardrails feedback <id luật> --note "...". Xem Khi bị Guardrails chặn.

Đọc thêm ​