Skill · Rule CLAUDE.md

Lập bản đồ ảnh hưởng trước khi sửa

Một forcing function buộc agent truy ai đang phụ thuộc vào một symbol, trước khi nó đổi.

DạngRule CLAUDE.md

Đổi tên một hàm, chỉnh cái nó trả về, sửa một giá trị mặc định — cảm giác như chỉ là một dòng. Agent sửa, file trông sạch, cái test nó chạy vẫn xanh. Cái nó không hề thấy là mười một chỗ khác từng gọi hàm đó và đang trông chờ hình dạng cũ. Những chỗ đó không vỡ ầm ĩ; chúng vỡ sau, ở nơi bạn không nhìn tới, lần lượt từng cái một.

Một symbol dùng chung không có khái niệm "sửa cục bộ". Mọi thay đổi lên nó là thay đổi lên tất cả những gì phụ thuộc vào nó — mà agent, khi làm trong một file, chỉ thấy đúng cái file trước mặt. Rule này buộc nó nhìn ra ngoài trước khi đụng vào bất cứ thứ gì đang gánh:

✕ Không có rule

Sửa thẳng hàm tại chỗ — file trông sạch

▼

Cái test duy nhất trong file này vẫn xanh

▼

Mười một nơi gọi vỡ sau — từng cái, ở production

✓ Có rule

Liệt kê trước mọi nơi gọi symbol đó

▼

Nói rõ cái gì vỡ nếu đổi hình dạng

▼

Bạn duyệt những chỗ đang gánh, trước khi sửa

Dán vào CLAUDE.md của bạn. Với một hàm riêng tư, độc lập, nó không tốn gì — chẳng có nơi gọi nào để liệt kê, rule tự nhường đường. Chỗ nó đáng giá là đúng nơi thiệt hại ẩn nấp: cái helper dùng chung, cái config key, cái signature công khai mà năm mươi thứ ngầm dựa vào. Find-and-replace là công cụ nguy hiểm nhất trong tình huống đó, vì nó thay chữ mà không hiểu đồ thị gọi — nên rule bắt agent truy trước khi đụng.

Dán vào CLAUDE.md

## Before editing shared code
Before changing a function, type, signature, or config value that other code depends on:
1. List every caller or dependent of the symbol you are about to change.
2. State the blast radius: what breaks if the change is wrong, and how far it reaches.
3. If it touches a widely-used symbol or a public interface, say so and wait for my go-ahead before editing.
Never change a shared signature with blind find-and-replace — trace the callers first, then edit.

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

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

## Before editing shared code
Before changing a function, type, signature, or config value that other code depends on:
1. List every caller or dependent of the symbol you are about to change.
2. State the blast radius: what breaks if the change is wrong, and how far it reaches.
3. If it touches a widely-used symbol or a public interface, say so and wait for my go-ahead before editing.
Never change a shared signature with blind find-and-replace — trace the callers first, then edit.

Bài này giúp được bạn không?

Thẻ#quy trình #claude.md #skill

Skill khác

01Kiểm chứng trước khi gọi là xong 02Plan trước, rồi mới code 04Việc có một đáp án thì đừng để model đoán 05Chẩn đoán từ triệu chứng, không từ phỏng đoán 06Bắt nó phản biện chính kế hoạch của nó 07Bàn giao cho phiên làm việc sau 08Một bản review không đóng dấu cho qua 09Chạy tới cổng thì dừng, không phải soi từng bước 10Bộ khung CLAUDE.md — biến file mô tả thành luật vận hành 11Vòng review hàng tuần — năm phút biến trải nghiệm thành kỹ năng 12Chia việc thành mảnh gọn, mỗi mảnh một context sạch 13Việc này có đáng giao cho agent không — hỏi trước khi mở chat 14Thử một việc nhỏ trước khi tin agent ở miền mới

Về Skill thực chiến

Người viết

Mỗi câu chuyện ở đây gói một bài học đã trả giá để học.

craftagentmột người vừa xây vừa học

Bạn đang xây gì với agent? Muốn trao đổi, phản biện, hay cùng làm một thứ gì đó — viết cho mình một dòng.

Viết thư hello@craftagent.cloud

58bài12cụmVI·ENsong ngữ

✕ Không có rule

✓ Có rule

Nhận bài mới qua email