freeze

Tổng quan về freeze skill

freeze làm gì

freeze là một skill tạo rào chắn, giới hạn việc chỉnh sửa file chỉ trong một thư mục duy nhất cho cả phiên làm việc. Nó chặn Edit và Write ở ngoài đường dẫn được phép, nên rất hữu ích khi bạn muốn một agent tự động hóa quy trình làm việc chỉ ở trong một module, một thư mục tính năng, hoặc một sandbox để gỡ lỗi. Nếu bạn cần freeze skill để ngăn những thay đổi lan rộng ngoài ý muốn, đây là lựa chọn phù hợp.

Ai nên cài đặt

Hãy cài freeze nếu bạn thường xuyên nhờ agent debug, refactor hoặc vá code trong một phạm vi hẹp và không muốn nó “nhiệt tình” chạm vào các file không liên quan. Skill này đặc biệt hữu ích cho maintainer, reviewer, và bất kỳ ai làm việc trong codebase pha trộn hoặc rủi ro cao, nơi ranh giới chỉnh sửa quan trọng hơn quyền tự do quá rộng.

Điểm khác biệt

Điểm khác biệt chính là khả năng cưỡng chế, không chỉ là hướng dẫn. freeze dùng pre-tool hook để từ chối các chỉnh sửa ngoài thư mục đã chọn, mạnh hơn nhiều so với một prompt chỉ nhắc mô hình “hãy tập trung”. Vì vậy, freeze guide thực sự hữu ích cho nhu cầu cô lập thay đổi trong thực tế, nhất là trong những phiên làm việc mà việc lệch phạm vi dù nhỏ cũng có thể tốn kém.

Cách dùng freeze skill

Cài đặt và khởi tạo ranh giới

Với freeze install, hãy thêm skill vào môi trường của bạn bằng trình quản lý skill của repository, rồi chọn thư mục bạn muốn khóa lại. Luồng thiết lập của skill là tương tác vì đường dẫn được phép là theo từng phiên làm việc. Trên thực tế, bạn nên sẵn sàng trả lời câu hỏi: “Thư mục nào cần được freeze?” bằng một đường dẫn chính xác, chứ không phải mô tả mơ hồ như “backend”.

Đọc trước các file này

Bắt đầu với SKILL.md để hiểu luồng điều khiển, sau đó xem bin/check-freeze.sh để biết ranh giới được thực thi như thế nào. Nếu bạn đang tùy biến skill, cũng nên xem SKILL.md.tmpl để hiểu cấu trúc được sinh ra. Những file này cho bạn biết freeze usage thực sự cho phép gì, chặn gì, và chỗ nào việc phân tích đường dẫn có thể lỗi hoặc chấp nhận lỏng hơn.

Đưa cho skill một prompt thật cụ thể

Đầu vào tốt nhất là một nhiệm vụ tập trung kèm ranh giới rõ ràng. Ví dụ: “Freeze các chỉnh sửa trong apps/payments và sửa các unit test đang fail ở đó mà không động vào shared libraries.” Câu này tốt hơn nhiều so với “debug app này”, vì freeze cần một thư mục đích và một nhiệm vụ phù hợp bên trong nó. Phạm vi càng chính xác, agent càng ít phải xin ngoại lệ.

Mẹo quy trình làm việc thực tế

Hãy dùng freeze khi lượt đầu tiên nên làm theo kiểu phẫu thuật: xác định lỗi, vá trong một thư mục, rồi kiểm tra lại mà không mở rộng phạm vi. Nếu nhiệm vụ thực sự đòi hỏi thay đổi xuyên nhiều thư mục, đừng cố ép nó vào freeze; hãy mở rộng đường dẫn được phép hoặc chọn một workflow khác. Skill này hoạt động tốt nhất khi tập thay đổi được yêu cầu vốn đã có ranh giới tự nhiên và bố cục repository rõ ràng.

FAQ về freeze skill

freeze chỉ dùng để debug thôi sao?

Không. Debug là một use case phổ biến, nhưng freeze skill cũng hỗ trợ các ca refactor có giới hạn, cô lập tính năng, và chỉnh sửa an toàn cho review. Câu hỏi cốt lõi là bạn có muốn agent chỉ ở trong một thư mục khi làm việc hay không.

Cái này khác gì prompt bình thường?

Một prompt bình thường phụ thuộc vào việc mô hình tự tuân thủ chỉ dẫn. freeze thêm cơ chế cưỡng chế qua hooks, nên các chỉnh sửa vượt ranh giới sẽ bị chặn ngay cả khi mô hình cố làm. Điều đó khiến nó đáng tin cậy hơn cho các job Workflow Automation, nơi các guardrail thực sự quan trọng.

freeze có thân thiện với người mới không?

Có, nếu người dùng có thể xác định một thư mục một cách chắc chắn. Sai lầm phổ biến của người mới là chọn ranh giới quá rộng hoặc quá hẹp. Nếu thư mục không rõ ràng, phiên làm việc có thể bị chậm lại trong lúc bạn phải làm rõ phạm vi.

Khi nào không nên dùng freeze?

Đừng dùng nó khi nhiệm vụ dự kiến sẽ đi qua nhiều module, shared configs, hoặc các bước format toàn repo. Trong những trường hợp đó, ràng buộc này có thể làm chậm việc hoặc gây ra các thao tác bị chặn không cần thiết. Freeze phù hợp nhất khi ranh giới là một quyết định thực sự, chứ không chỉ là sở thích.

Cách cải thiện freeze skill

Làm ranh giới thật rõ

Mức cải thiện chất lượng lớn nhất đến từ việc nêu chính xác thư mục và kết quả mong muốn cùng lúc. Một đầu vào tốt sẽ như: “Freeze các chỉnh sửa trong services/auth và cập nhật luồng token refresh mà không chạm vào shared/.” Đầu vào yếu như “sửa auth” sẽ buộc agent phải đoán, và làm tăng nguy cơ bị chặn hoặc sửa dang dở.

Cung cấp file, triệu chứng và giới hạn

Để dùng freeze tốt hơn, hãy nêu file đang lỗi, hành vi quan sát được, và những file ngoài phạm vi. Ví dụ: “Chỉ sửa apps/admin; lỗi nằm ở src/table.ts; đừng thay đổi API contracts.” Điều này giúp agent ở đúng vùng đã freeze nhưng vẫn giải quyết được vấn đề thật.

Chú ý khi ranh giới không khớp

Lỗi thường gặp nhất là nhiệm vụ thực ra cần phạm vi rộng hơn thư mục đã freeze. Nếu agent liên tục bị từ chối ghi file, cách sửa thường là mở rộng ranh giới hoặc chia nhiệm vụ thành nhiều giai đoạn. Đây là một tính năng, không phải lỗi: freeze đang báo cho bạn biết kế hoạch và phạm vi hiện tại không khớp.

Lặp lại sau lượt đầu tiên

Sau kết quả đầu tiên, hãy xem giải pháp có dựa vào giả định nằm ngoài đường dẫn đã freeze hay không. Nếu có, hãy siết lại prompt bằng một hoặc hai ràng buộc cụ thể: thư mục mục tiêu, loại file được phép, và phần nào phải giữ nguyên. Để đạt kết quả tốt nhất với freeze skill, hãy lặp lại bằng cách làm rõ phạm vi, không phải bằng cách yêu cầu thêm tính sáng tạo.