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

Giới thiệu PhillipCLI ​

PhillipCLI là nền tảng giúp đội làm phần mềm dùng AI agent theo một cách chung, có kiểm soát và đo được. Đọc trang này xong, bạn biết nền tảng gồm những gì và một task đi qua nó thế nào. Sau đó bạn chọn vai trò ở cuối trang để bắt đầu.

Vì sao cần một nền tảng? ​

Đội nào bắt đầu dùng AI agent cũng gặp cùng một chuyện. Mỗi người tự viết prompt riêng, tự cài công cụ riêng, nên cách làm của người này không dùng lại được cho người kia. Agent chạy ngay trên máy với quyền của bạn, nên ai cũng ngại một lệnh xóa nhầm hay một file bí mật bị đọc ra ngoài. Còn đến cuối quý, khi sếp hỏi AI giúp được bao nhiêu và tốn bao nhiêu, thường chẳng ai có con số.

PhillipCLI giải quyết đúng ba chỗ đó. Cả đội dùng chung một bộ tài nguyên đã duyệt. Agent làm việc trong vùng có người canh. Và mọi task đều để lại số liệu, nên bạn nhìn được AI đang giúp ở đâu.

Bốn phần của nền tảng ​

Nền tảng chia thành bốn phần, mỗi phần lo một việc.

Sơ đồ kiến trúc. Trên máy bạn có Phillip, Claude Code với Guardrails và Bandum. Online có Tara, Ryoma và Grafana. GitHub hoặc GitLab giữ dữ liệu gốc. Máy bạn chủ động đẩy dữ liệu ra, dịch vụ online không gọi ngược vào máy.Trên máy bạnOnlinePhillipCLI ph và VS CodeClaude CodeGuardrails canh lệnhBandumBảng task, kiểm thửTaraKho tài nguyên, PortalRyomaSố liệu Flow và AIGrafanaDashboard vận hành nội bộGitHub hoặc GitLabNguồn sự thật: issue, nhãn, PR, file testcasechạy qua phCài tài nguyên, đăng nhậpTelemetry đã lọcdashboardTask, nhãn, file kiểm thửĐọc tiến độ task

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

Mũi tên chỉ chiều dữ liệu đi. Phillip và Bandum chủ động gọi ra ngoài, còn dịch vụ online không gọi ngược vào máy bạn.

Tara là nơi dùng chung. Đó là kho skill, agent, kit và harness đã qua kiểm tự động và người duyệt, rồi được ký số trước khi ai đó cài. Tara cũng lo đăng nhập, tổ chức (thành viên, role, project) và có cổng web để mọi người khám phá, duyệt và xem dự án. Tara chạy online và dùng chung: mỗi tổ chức chỉ thấy dữ liệu của mình.

Phillip là phần dành cho người làm. Đó là lệnh ph kèm extension VS Code, chạy trên máy bạn. Phillip cài tài nguyên từ Tara, mở Claude Code với đúng cấu hình của dự án và nhận task cho bạn. Guardrails cũng nằm trong Phillip: nó canh các lệnh nguy hiểm và dữ liệu nhạy cảm trước khi agent kịp chạm vào.

Bandum khép vòng giao việc và nghiệm thu. Task là issue, trạng thái là nhãn, testcase và kết quả kiểm thử là file trong repo, còn Bandum là giao diện và lệnh để làm việc với những thứ đó. Dev và Test dùng Bandum trên máy, còn BA kiểm thử ngay trên trang web của Bandum.

Ryoma đo kết quả. Nó gom tiến độ giao hàng và chi phí AI về dashboard theo project của từng tổ chức, rồi gửi bản tin tuần cho người liên hệ của project. Ryoma chạy online cùng Tara.

Nói gọn, Dev và Test dùng Phillip với Bandum trên máy. BA, PO và PM chỉ cần trình duyệt để vào Tara.

Một task đi qua hệ thống thế nào? ​

Thử theo một task thật, ví dụ thêm chức năng đổi mật khẩu cho acme/shop-web.

Hành trình một task qua năm làn. BA viết issue có tiêu chí nghiệm thu. Dev nhận task bằng ph bandum start, agent làm việc dưới sự canh của Guardrails, rồi chạy verify, mở PR và chuyển sang kiểm thử bằng review. BA kiểm thử nghiệm thu, rồi Duyệt hoặc Trả lại. Trả lại thì dev chạy fix và quay lại làm việc với agent. Duyệt xong thì task Done, Ryoma ghi số liệu và gửi bản tin tuần cho PM.BA / PODev và agentGuardrailsBandumRyoma / PMViết issueAC và nhãnNhận taskph bandum startTạo nhánhkhung testcaseAgent làm việcdùng Claude CodeGuardrailschặn, che,ghi nhật kýKiểm tự độngph bandum verifyMở PRph bandum prChuyển kiểm thửph bandum reviewĐổi nhãnstatus: reviewKiểm thửnghiệm thuTrả lạicó TCkhông đạtDuyệtmọi TC đạtDoneđóng issueGhi số liệuFlow vàchi phí AIBản tin tuầngửi PMsáng thứ HaiKhông đạtĐạtph bandum fix

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

Task bị trả lại thì vòng ph bandum fix lặp đến khi người kiểm thử bấm Duyệt. Bandum tự đổi nhãn trạng thái ở mỗi bước.

Chị BA mở GitLab (hoặc GitHub) của dự án và viết issue, trong đó liệt kê tiêu chí nghiệm thu (AC): đổi được khi nhập đúng mật khẩu cũ, báo lỗi khi mật khẩu mới quá ngắn. Issue có đủ nhãn loại việc và mức lớn nhỏ, nhờ vậy Ryoma biết cách tính cho nó.

Anh dev mở terminal trong repo và chạy ph bandum start GH-12. Phillip nhận task, tạo nhánh và dựng sẵn khung testcase, mỗi AC có một mục chờ anh điền. Anh làm việc với Claude Code như thường lệ. Lúc này agent chạy trong vùng an toàn của dự án, còn Guardrails đứng cạnh canh lệnh. Khi agent định chạy một lệnh quá rủi ro, Guardrails chặn lại và nói rõ lý do, anh không phải đoán.

Làm xong, anh chạy ph bandum verify GH-12 để kiểm tra tự động theo từng testcase, mở PR bằng ph bandum pr GH-12 rồi chuyển task sang kiểm thử bằng ph bandum review GH-12. Bandum tự đổi nhãn trạng thái, anh không cần gắn.

Chị BA nhận task ở cột Waiting for testing (chờ kiểm thử), mở trang task trên web và chấm từng testcase là Pass hoặc Fail. Testcase nào không đạt thì chị mô tả lỗi. Nếu mọi testcase đạt, chị bấm Approve (duyệt). Nếu không, chị bấm Send back (trả lại), task quay về cho anh dev sửa rồi vào kiểm thử lại.

Ngay khi task xong, Ryoma ghi nhận thời gian từ lúc bắt đầu đến lúc xong, số lần bị trả lại và chi phí AI đã dùng cho task. Sáng thứ Hai, PM nhận bản tin tuần tóm tắt những con số đó của cả dự án.

Chi tiết từng bước, kể cả khi task bị trả lại, nằm ở Vòng đời một task.

Board của Bandum cho cả nhóm thấy mỗi task đang ở đâu, lấy từ issue trên GitHub hoặc GitLab.

Nền tảng giữ những nguyên tắc nào? ​

Mã nguồn và thao tác ở lại máy bạn. Phillip và Bandum chủ động gửi dữ liệu lên, còn dịch vụ online không bao giờ gọi ngược vào máy bạn. Phần được gửi đi nằm ở Dữ liệu thu thập.

Mọi tài nguyên đều qua duyệt và có chữ ký. Tara chỉ ký sau khi tài nguyên qua kiểm tự động và có người duyệt, và Phillip kiểm lại chữ ký trước khi nạp. Vì vậy thứ chạy trên máy bạn đúng là thứ đã được duyệt.

Đo để cải thiện quy trình, không để chấm điểm từng người. Số liệu tính theo dự án và luồng công việc. Số liệu của từng người chỉ phục vụ hạn mức chi phí, và chỉ người đó cùng quản trị xem được.

Cuối cùng, nền tảng tích hợp qua plugin chứ không trói vào một nhà cung cấp. Muốn nối công cụ nào thì viết một kit cho công cụ đó, còn lõi của Phillip không chứa mã riêng cho bên nào.

Hiện nay hỗ trợ những gì? ​

Claude Code là công cụ lập trình AI chính, và tài nguyên của Tara cài vào đó như mọi plugin. Về kho mã, nền tảng làm việc với GitHub và GitLab. Với quản lý công việc, Jira nối qua kit tracker, và phần đọc task từ Jira cho Ryoma đang trong kế hoạch.

Một số hướng chưa có: dùng công cụ lập trình AI khác ngoài Claude Code, chạy model tự host, hay bộ đánh giá riêng cho agent. Những hướng này mới đang cân nhắc, chưa phải cam kết. Việc gì đang làm, sắp có hay đang cân nhắc đều ghi ở Lộ trình.

Sẵn sàng bắt đầu? ​

Chọn lối vào theo việc bạn làm. Muốn hiểu kỹ cách các phần nối với nhau thì đọc thêm Kiến trúc.