Viết quy tắc con trỏ khiến AI hoạt động trong cơ sở mã cũ

Tuần đầu tiên tôi phát triển theo hướng tác nhân trong cơ sở mã bốn năm tuổi của chúng tôi đã tạo ra mã đẹp vi phạm ba quy ước nhóm và một quyết định về kiến trúc mà chúng tôi đã đấu tranh trong nhiều tháng. Việc sửa lỗi không được nhắc nhở tốt hơn; đó là việc viết ra hiến pháp.

Một tệp quy tắc tốt là tệp ngắn và tiêu cực. Danh sách của tôi liệt kê những điều mà cơ sở mã không bao giờ phải làm: không có thư viện quản lý trạng thái mới, ngày tháng không phải là Ngày tháng, mọi tuyến API đều xác thực với các lược đồ zod hiện có và không bao giờ chạm vào các tệp theo kế thừa/mà không hỏi. Những ràng buộc, chứ không phải khát vọng, là những gì làm thay đổi hành vi của mô hình.

Chiến thắng bất ngờ đã ghi lại lý do tại sao cho mỗi quy tắc trong một mệnh đề. Mô hình biết quá trình di chuyển đã bị phá vỡ trong quý trước viết mã di chuyển thận trọng hơn mô hình chỉ yêu cầu hãy cẩn thận. Ngữ cảnh chuyển đổi các quy tắc từ tuân theo thành hiểu và hiểu các quy tắc khái quát hóa cho các trường hợp bạn không liệt kê.

Giữ một tệp quy tắc thứ hai cho mỗi thư mục cho các quy ước cục bộ, thư mục thành phần của tôi có tệp riêng và chống lại sự thôi thúc làm phình to tệp toàn cầu. Tôi cắt bản nháp đầu tiên của mình từ 40 dòng xuống còn 12 dòng và những khác biệt trở nên tốt hơn, bởi vì mỗi dòng bạn thêm vào sẽ làm loãng những dòng quan trọng.

Sáu tuần sau, kết quả có thể đo lường được: những khác biệt vi phạm quy ước đã giảm từ khoảng một phần ba xuống mức hiếm khi và các nhận xét đánh giá mã đã chuyển từ phong cách trở lại logic. Hồ sơ quy tắc là kỹ sư cao cấp rẻ nhất mà tôi từng thuê.