Recursive Agent Tree Boilerplate

Cây nhân sự AI đệ quy 3 tầng trên nền tảng Antigravity 2.0

Khung gầm mẫu để thiết lập, điều phối và kiểm soát một hệ thống nhân sự AI phân cấp, trong đó mỗi tầng có vai trò, quyền hạn và nguyên tắc vận hành riêng.

Chức năng cụ thể của recursive-agent-tree-boilerplate.md

File này đóng vai trò là một khung gầm mẫu boilerplate template, cung cấp toàn bộ mã nguồn cấu hình JSON và kịch bản prompt tiêu chuẩn để thiết lập cấu trúc Cây nhân sự AI đệ quy 3 tầng trên nền tảng Antigravity 2.0.

Chức năng cụ thể được phân bổ theo mô hình vận hành sau:

A. Định hình cấu trúc phân cấp đệ quy 3 tầng

1

Tầng 1: Sếp tổng

Anh hoặc Agent chính chỉ cần giao một siêu đề bài hoặc mục tiêu vĩ mô duy nhất cho Tầng 2 bằng lệnh invoke_subagent.

Tầng này không cần can thiệp sâu vào chi tiết kỹ thuật bên dưới.

2

Tầng 2: Trưởng phòng project-manager

Được cấp quyền điều phối nhân sự nâng cao với enable_subagent_tools: true.

Nhận siêu dự án từ Sếp tổng, tự động phân tích và phân rã thành các mảng việc chuyên môn.

3

Tầng 3: Nhân viên task-worker

Bị khóa quyền đẻ thêm con với enable_subagent_tools: false để tránh lỗi vòng lặp đệ quy vô hạn.

Tập trung 100% vào một nhiệm vụ chuyên trách được Trưởng phòng giao.

Luồng vận hành của Tầng 2

  • Tự tuyển dụng bằng lệnh define_subagent và kích hoạt bằng lệnh invoke_subagent đồng loạt các nhân viên cấp dưới ở Tầng 3.
  • Chờ nhận báo cáo từ các nhân viên con.
  • Tự động thu dọn tài nguyên hệ thống bằng lệnh kill_all để tránh tình trạng các agent con chạy ngầm gây lãng phí token, còn gọi là Zombie Agents.
  • Tổng hợp tất cả báo cáo chi tiết thành một bản Master Plan vĩ mô và gửi thông tin tổng kết ngược lên Tầng 1.

Luồng thực thi của Tầng 3

  • Không được tạo thêm subagent mới để tránh Infinite Loop.
  • Thực thi một nhiệm vụ duy nhất theo phân công của Trưởng phòng.
  • Tự viết file báo cáo chi tiết theo định dạng Markdown chuẩn vào các thư mục P.A.R.A.
  • Báo cáo trạng thái hoàn thành cho Trưởng phòng sau khi kết thúc nhiệm vụ.

B. Cung cấp mã JSON và Prompt mẫu ăn liền

File chứa sẵn các đoạn mã cấu hình thực tế để anh có thể sao chép, chỉnh sửa và triển khai ngay trong quy trình làm việc.

  1. Lệnh define_subagent để định nghĩa Trưởng phòng project-manager.
  2. Lệnh invoke_subagent để Sếp tổng giao siêu dự án tuần cho Trưởng phòng.
  3. Lệnh define_subagent để Trưởng phòng định nghĩa Nhân viên cấp dưới task-worker.
  4. Lệnh invoke_subagent để Trưởng phòng phân việc song song cho 3 Nhân viên: Biên soạn nội dung, Lập ngân sách tài chính, và Thiết kế hình ảnh marketing.

C. Thiết lập 4 nguyên tắc thực chiến chống lỗi

File hướng dẫn chi tiết các tiêu chuẩn kỹ thuật sống còn khi vận hành cây nhân sự AI.

1. Nguyên tắc phân quyền tối thiểu

Áp dụng Least Privilege: khóa quyền tự tạo subagent của các nhân viên Tầng 3 để tránh lạm dụng token và ngăn hệ thống tự mở rộng ngoài kiểm soát.

2. Quy trình dọn rác cơ học

Luôn chạy kill_all ngay sau khi thu hoạch báo cáo để giải phóng agent con và hạn chế thất thoát tài nguyên hệ thống.

3. Đường dẫn tuyệt đối

Bắt buộc chỉ định đường dẫn tuyệt đối trong prompt giao việc để tránh ghi file sai vị trí hoặc thất lạc báo cáo trong thư mục không mong muốn.

4. Không dùng dấu em-dash

Không dùng ký tự — để đồng bộ văn phong hệ thống theo quy chuẩn của Personal Assistant.

Nội dung được tổng hợp và thiết kế bởi Minh Đỗ