Skill · Rule CLAUDE.md

Kiểm chứng trước khi gọi là xong

Một forcing function buộc agent chứng minh bản sửa, thay vì chỉ khai là xong.

DạngRule CLAUDE.md

Bạn nhờ agent sửa một lỗi. Nó trả về nhanh: "Xong — cái nút hiện ra rồi." Diff trông hợp lý, nên bạn đi tiếp. Hai giờ sau cái nút vẫn không thấy đâu. Diff là thật; kết quả thì không. Ở đâu đó giữa dòng code và màn hình, một cache cũ hay một dòng CSS đè lên đã âm thầm nuốt mất nó — và không ai nhìn.

Khoảng trống đó có đúng một nguyên nhân: agent đưa cho bạn một lời khai, và bạn nhận nó như bằng chứng. Một câu "xong" tự tin là thứ mô hình tạo ra dễ nhất — không tốn gì và cũng chẳng chứng minh gì. Xem cái gì đổi khi bạn bắt "xong" phải trả giá bằng bằng chứng:

✕ Không có rule

Agent: "Sửa xong rồi — trông đúng mà."

▼

Bạn tin lời khai và ship luôn

▼

Nó chưa từng chạy — vỡ ở production, dưới tên bạn

✓ Có rule

Agent chạy đường thật

▼

Dán output thật + dấu hiệu chứng minh

▼

Bạn thấy nó chạy trước khi tin

Dán vào CLAUDE.md của bạn — toàn cục, hoặc theo project. Tốn của agent vài giây mỗi thay đổi, và tiết kiệm cho bạn nửa ngày gỡ một bản sửa chưa từng chạy. Chỗ nó đáng giá nhất là lần thứ hai bạn nghe "vẫn lỗi": câu đó nghĩa là chẩn đoán đầu đã sai, không phải làm chưa tới — nên rule buộc agent chẩn đoán lại từ output quan sát được, thay vì vá lại cùng một phỏng đoán.

Dán vào CLAUDE.md

## Verification — before reporting "done"
Never report a change as done on inspection alone. First:
1. Run the real path — render the page / hit the endpoint / execute the command.
2. Paste the actual output here. Do not describe it; show it.
3. State the one observable signal that proves it works (a value, an exit code, a rendered element).
A confident tone is not evidence. If the user says "still broken," re-diagnose from the observed output — do not re-apply the same fix on a new guess.

Muốn agent tự cài hộ?

Thêm rule này vào CLAUDE.md của tôi, nguyên văn:

## Verification — before reporting "done"
Never report a change as done on inspection alone. First:
1. Run the real path — render the page / hit the endpoint / execute the command.
2. Paste the actual output here. Do not describe it; show it.
3. State the one observable signal that proves it works (a value, an exit code, a rendered element).
A confident tone is not evidence. If the user says "still broken," re-diagnose from the observed output — do not re-apply the same fix on a new guess.