ralph-loop - Tự động hóa công việc phát triển với vòng lặp tác nhân AI chạy dài hạn

• Hệ thống vòng lặp AI chạy dài hạn lặp đi lặp lại duyệt qua danh sách công việc và thực hiện cho đến khi hoàn tất
• Chạy an toàn các AI CLI như Claude Code/Codex/Gemini trong môi trường sandbox Docker
• Cách vận hành
  • Bước 1: Cài Ralph npx @pageai/ralph-loop
  • Bước 2: Viết PRD (tài liệu yêu cầu sản phẩm) và danh sách tác vụ: dùng kỹ năng prd-creator để tạo PRD từ yêu cầu và rà soát từng tác vụ
  • Bước 3: Thiết lập tác nhân trong sandbox Docker
    • Chạy docker sandbox run claude . để đăng nhập
    • Nhất định phải chọn Yes cho Bypass Permissions mode. Đây là lý do sử dụng sandbox
  • Bước 4: Chạy Ralph ./ralph.sh -n 50 # Chạy lặp Ralph Loop 50 lần
• Cách hoạt động: ở mỗi vòng lặp, Ralph sẽ làm các việc sau
  • 1. Tìm công việc chưa hoàn thành có mức ưu tiên cao nhất trong tệp .agent/tasks.json
  • 2. Thực hiện các bước công việc theo đúng thứ tự được định nghĩa trong .agent/tasks/TASK-{ID}.json
  • 3. Chạy test·linter·kiểm tra kiểu
  • 4. Hoàn tất công việc, chụp ảnh màn hình, cập nhật trạng thái công việc và commit thay đổi
• Điểm khác biệt của phiên bản PageAI này so với các loop Ralph Wiggum khác
  • Tạo PRD và trích xuất danh sách tác vụ từ yêu cầu
  • Tạo bảng tra cứu tác vụ từ PRD
  • Phân rã bước công việc và chia thành các bước có thể quản lý được
  • Theo dõi tiến độ lặp lại (hiển thị kèm thời gian)
  • Xem trước luồng đầu ra thời gian thực và phát hiện giai đoạn hoạt động (Thinking, Testing, v.v.)
  • Chụp ảnh màn hình hiện tại
  • Gửi thông báo khi cần con người nhập liệu
  • Ghi log lịch sử với đầu ra gọn gàng cho từng vòng lặp
  • Hiển thị chỉ số thời gian cho từng vòng lặp và toàn bộ thời gian
  • Có thể ưu tiên xử lý công việc quan trọng bằng tính năng Steering
  • Ngoài ra
    • Khi nhập yêu cầu không có cấu trúc, tác nhân sẽ tự động tạo PRD và danh sách công việc
    • Sử dụng bảng tra cứu công việc có kèm các bước chi tiết riêng lẻ nên mở rộng rất tốt khi cần xử lý hàng trăm công việc
    • Chạy trong môi trường sandbox nên bảo mật hơn
    • Hiển thị tiến độ và thống kê để dễ dàng xác nhận các công việc đã hoàn thành
    • Chỉ thị cho tác nhân tạo và chạy test tự động cùng ảnh chụp màn hình cho từng công việc
    • Cung cấp khả năng quan sát và truy vết đối với công việc của tác nhân
    • Hiển thị luồng đầu ra và ghi lại nhật ký lịch sử đầy đủ cho từng vòng lặp
• Giấy phép MIT