Skip to content
← Tất cả các chương

Chương 05

Các kiểu hình repository

Trước khi thay đổi bất kỳ dòng nào, agent đưa ra một quyết định định hình tất cả những gì tiếp theo: đây là loại repository nào? Kiểu hình mà nó suy ra xác lập ranh giới mà nó sẽ lý luận trong suốt phần việc — cách nó khởi tạo, một kế hoạch vươn tới đâu, và trạng thái được lưu trữ ở đâu. Xác định sai, agent sẽ giới hạn phạm vi công việc vào sai bề mặt — nguồn gốc phổ biến nhất của hiện tượng drift trong các tác vụ dài hạn. Xác định đúng, agent có thể hoạt động tự chủ trong nhiều giờ, vì các kế hoạch, quá trình khởi tạo và trạng thái đều phù hợp với hình dạng thực của mã nguồn.

DWP nhận diện hai kiểu hình. Hầu hết các repository thuộc về kiểu đầu tiên; kiểu thứ hai dành cho các nhóm điều phối nhiều repository.

Repository độc lập

Trường hợp thông thường: một codebase khép kín — một ứng dụng, một thư viện, hay một dịch vụ. Có một bề mặt mạch lạc duy nhất để lý luận, vì vậy các kế hoạch tác động trực tiếp lên mã trong repository và việc khởi tạo đọc cấu trúc cùng quy ước của chính repository đó. Agent nắm giữ toàn bộ codebase làm ngữ cảnh và xử lý nó từ đầu đến cuối.

Đặc điểm:

  • Một codebase mạch lạc duy nhất.
  • Các kế hoạch sửa đổi tệp trong repository này.
  • Không gian làm việc .dwp/ nằm tại gốc repository.

Trung tâm điều phối

Trường hợp điều phối: một repository mà nhiệm vụ của nó là quản lý các repository khác. Ở đây đơn vị công việc không phải là một tệp mà là một repository con, vì vậy các kế hoạch có thể sinh ra các kế hoạch con trong các sub-repository, và việc khởi tạo đọc danh bạ các repository được quản lý của trung tâm thay vì một codebase duy nhất. Agent lý luận về các ranh giới và quá trình chuyển giao — repository nào sở hữu công việc nào, và trạng thái của chúng duy trì nhất quán như thế nào.

Đặc điểm:

  • Điều phối nhiều sub-repository.
  • Các kế hoạch có thể ủy thác cho các kế hoạch con.
  • Duy trì một danh bạ các repository được quản lý.
  • Không gian làm việc .dwp/ tại gốc trung tâm theo dõi trạng thái xuyên repository.

Phép suy đoán phân loại

Hai kiểu hình trông khác nhau trên đĩa, và agent quyết định giữa chúng dựa trên các tín hiệu có thể xác minh — không phải nhãn được cung cấp sẵn. Cây quyết định bên dưới cho thấy con đường; nói ngắn gọn, chỉ coi một repository là trung tâm điều phối khi bằng chứng đòi hỏi như vậy, còn lại là repository độc lập.

Một agent nên phân loại một repository là trung tâm điều phối khi nó tìm thấy nhiều repository git lồng nhau hoặc submodule, một danh bạ hay manifest các repository được quản lý, hoặc cấu hình trỏ tới các repository bên ngoài. Khi không có các dấu hiệu đó, nó coi repository là một repository độc lập — giá trị mặc định an toàn, vì mở rộng phạm vi kế hoạch vượt qua các ranh giới không tồn tại còn tệ hơn là làm việc trong một ranh giới có thực.

Khởi tạo khác nhau như thế nào

Kiểu hình không phải nhãn trang trí; nó thay đổi những gì agent đọc, những gì kế hoạch có thể chạm tới, và nơi trạng thái được ghi lại.

Khía cạnh Độc lập Điều phối
Phạm vi Repository này Nhiều repository
Khởi tạo Cấu trúc repository Danh bạ trung tâm
Đích kế hoạch Tệp cục bộ Các kế hoạch con
Trạng thái .dwp/ cục bộ .dwp/ xuyên repository

Hệ quả thực tế là một agent repository độc lập suy luận về một codebase từ đầu tới cuối, trong khi một agent điều phối suy luận về sự điều phối — repository con nào sở hữu công việc nào, và làm sao trạng thái xuyên repository luôn nhất quán.

Đây là điều cho phép một agent làm việc tự chủ trong nhiều giờ mà không cần giám sát: bằng cách xác lập kiểu hình trước tiên, nó giới hạn phạm vi các kế hoạch, việc khởi tạo và trạng thái vào đúng ranh giới, để mọi tác vụ từ đầu tiên tới cuối cùng đều vận hành trên bề mặt chính xác.