Xây dựng vòng lặp kiểm chứng tự động trong Claude Code với tính năng Skills

Biến nó thành một skill

Cách phổ biến nhất để mã hóa các bước lặp đi lặp lại vào một vòng lặp xác thực (verification loop) là viết nó dưới dạng một skill, và cách nhanh nhất để tạo một skill là cài đặt plugin skill-creator và để Claude phỏng vấn bạn:

Ví dụ:

Bạn cũng có thể tự viết một skill bằng cách thả một tệp markdown vào thư mục.claude/skills/ trong dự án của mình. Skill xác thực đơn giản nhất bao gồm một vài dòng frontmatter cộng với phần nội dung:

Lược đồ đầy đủ và triết lý đằng sau nó nằm trong hướng dẫn toàn diện của chúng tôi về cách xây dựng skill.

Khớp kiểm tra với nơi nó chạy

Điều tiếp theo cần xác định là cách vòng lặp xác thực bắt đầu: độc lập (standalone), nhúng (embedded), chuỗi (chained), hoặc gắn với PR.

Độc lập (Standalone)

Bạn chủ động gọi nó sau khi artifact đã tồn tại. Một skill độc lập phát huy tác dụng đối với các kiểm tra chéo không áp dụng mọi lúc: quét bảo mật trước khi commit, kiểm tra khả năng truy cập trước khi PR, xác thực tiêu đề bản quyền (license-header) trên toàn bộ repo. Bất cứ thứ gì bạn muốn khả dụng trên nhiều quy trình làm việc nhưng không muốn nó kích hoạt sau mỗi lần thay đổi mã.

Cái giá phải trả là mỗi lần gọi vẫn là một lượt mà bạn phải tự nhớ thực hiện. Dấu hiệu cho thấy bạn đã vượt quá nhu cầu sử dụng standalone là khi bạn chạy nó sau mỗi thay đổi. Tại thời điểm đó, quy trình này đã xứng đáng có một vị trí cố định: hãy nhúng nó hoặc tạo chuỗi cho nó.

Nhúng (Embedded)

Tự động kích hoạt như một phần của skill tạo ra nó. Việc kiểm tra thuộc về một quy trình làm việc cụ thể và quy trình đó hiện chạy nó mà bạn không cần yêu cầu.

Phiên bản đơn giản nhất là thêm một dòng vào phần thân của skill tạo ra nó:

Xác minh việc nhúng hoạt động bằng cách gọi skill trên một tác vụ mới và xác nhận bước mới chạy như một phần của kết quả đầu ra. Nếu không, mô tả của skill hoặc các hướng dẫn trước đó không bao gồm bước kiểm tra được thêm vào.

Việc nhúng chỉ hoạt động trên các skill mà bạn có thể chỉnh sửa: những skill bạn tự viết hoặc những skill được cài đặt ở cấp độ dự án nơi tệp SKILL.md nằm trong tầm kiểm soát của bạn. Các skill tích hợp sẵn và skill do plugin quản lý (loại bị ghi đè khi cập nhật) không áp dụng được mô hình này; đối với những loại đó, hãy sử dụng chuỗi (chain).

Bỏ qua việc nhúng đối với các kiểm tra trải dài trên nhiều quy trình làm việc; những kiểm tra đó cần dạng độc lập để bạn có thể gọi chúng từ bất kỳ ngữ cảnh nào.

Chuỗi (Chained)

Một skill gọi một skill khác ở cuối quy trình và một vài bước bàn giao đã xác thực chạy từ đầu đến cuối.

Các thành viên trong nhóm Claude Code của Anthropic sử dụng mô hình này trong công việc hàng ngày của họ: /code-review tìm lỗi, /simplify làm sạch diff, một skill /verify xác nhận hành vi từ đầu đến cuối, và một skill /custom /design kiểm tra dựa trên các nguyên tắc trong tệp DESIGN.md nếu thay đổi đó ảnh hưởng đến UI.

Tạo chuỗi cũng là cách bạn thêm xác thực vào một skill mà bạn không thể sửa đổi: xây dựng một skill wrapper tùy chỉnh gọi skill gốc, sau đó gọi skill xác thực của bạn, như mô tả dưới đây:

Những gì bắt đầu như một thói quen ("Tôi luôn chạy /verify sau /simplify") trở thành một hợp đồng ("/simplify luôn chạy /verify khi nó hoàn tất"). Chuỗi này tự chạy toàn bộ chu kỳ phát triển. Bạn chỉ can thiệp khi có vấn đề phát sinh.

Bạn có thể bỏ qua việc tạo chuỗi khi các bước đủ độc lập đến mức đôi khi bạn muốn chạy một bước mà không cần các bước còn lại; tạo chuỗi là sự đánh đổi giữa tính linh hoạt và tự động hóa. Các vòng lặp xác thực theo chuỗi có thể làm tăng mức tiêu thụ token, vì vậy tốt nhất là nên kiểm tra các vòng lặp này trước khi triển khai rộng rãi.

Trên mỗi PR

Khi chuỗi đã ổn định cho các thay đổi của riêng bạn, quy trình tương tự có thể chạy trên mỗi PR. Thay đổi của đồng nghiệp sẽ vượt qua các cổng kiểm soát giống như của bạn, bất kể họ có nhớ gọi chuỗi hay không. Cơ sở hạ tầng này cũng giống như chuỗi bạn đã viết, chỉ tiến thêm một bước: cùng các skill, cùng các tiêu chí, cùng các tiêu chuẩn, được áp dụng mà không phụ thuộc vào sự cẩn thận của tác giả.

Đây là lúc xác thực không còn là cơ sở hạ tầng cá nhân mà trở thành cơ sở hạ tầng của nhóm. Việc kiểm tra mà bạn viết ra để tiết kiệm cho mình hai phút mỗi tuần giờ đây đang tiết kiệm cho mọi người hai phút mỗi tuần, trên mỗi thay đổi. Hãy tạm dừng các cổng kiểm soát trên toàn PR trong khi chuỗi vẫn còn đang thay đổi; mỗi điều chỉnh đều trở thành một sự kiện mà cả nhóm đều thấy.

Khi bạn đã nắm vững quy trình, bạn đã sẵn sàng mở rộng kỹ thuật vòng lặp của mình. Quy trình tạo vòng lặp xác thực là nhất quán, bất kể bạn đang tự động hóa cái gì hoặc trong môi trường nào:

Bạn càng mã hóa nhiều để Claude tuân theo, phản hồi của Claude càng gần với những gì bạn muốn ngay từ lần thử đầu tiên. Những chỉnh sửa mà bạn không còn phải loay hoay nữa giờ đây giải phóng sự chú ý của bạn cho công việc cá nhân và độc quyền mà không skill nào có thể viết thay bạn.

Bắt đầu với các vòng lặp xác thực trong Claude Code.

Bài viết này được viết bởi Delba de Oliveira, một thành viên của nhóm Claude Code.