Grill TDD Debug với Skills
Đi sâu: grill-with-docs, TDD đỏ-xanh-tái cấu trúc, chẩn đoán bug kỷ luật, review giữ chuẩn.
Align trước, feedback loop sau, design xuyên suốt. Đây là bài 2 series mattpocock/skills ↗ — vòng hands-on: /grill-with-docs → /tdd → /diagnosing-bugs → /code-review. Bài 1 là overview.
Vòng lặp trong một hình#
[!NOTE] Grill chỉ đáng nếu bạn trả lời nghiêm túc. Trả lời ngắn, build mơ hồ. Skill ép mọi nhánh design tree resolved trước code.
1. Grill-with-docs: phỏng vấn cộng shared language#
/grill-me phỏng vấn relentless mọi plan. /grill-with-docs thêm đồ engineering: mài术语 vào GLOSSARY.md, ghi quyết định khó thành ADR inline.
ELI5: agent đóng đứa 5 tuổi bướng hỏi “tại sao” tới khi hết mơ hồ — rồi ghi lại từ đã thống nhất để session sau khởi đầu thông minh.
/grill-with-docs
# agent: "Done nghĩa là gì? Đụng module nào?"
# agent: "'publish' là persist, enqueue, hay notify?"
# kết quả:术语 vào GLOSSARY.md, quyết định vào docs/adr/textPayoff cộng dồn: ngôn ngữ gọn → tên biến/hàm/file nhất quán → navigate dễ → tốn ít thinking token.
[!TIP] Grill mọi change, không chỉ change lớn. Popular nhất repo có lý do.
2. TDD: đỏ-xanh-tái cấu trúc mỗi slice#
Skill /tdd gắn mọi project: mỗi lần một vertical slice, test qua public interface, không bao giờ test internals.
# RED: test fail cho một slice
# GREEN: change nhỏ nhất cho pass
# REFACTOR: deepen module — behavior nhiều, interface vẫn nhỏ
# lặp mỗi slice; /implement lái ở seam đã hẹntextTốt vs dở, theo skill:
- Tốt: behavior qua public interface, một slice, tên từ glossary
- Dở: test internals, slice khổng lồ, mock unit thành vô nghĩa
3. Diagnosing-bugs: vòng kỷ luật, gated phase#
Bug khó và perf regression, /diagnosing-bugs bọc best practice thành vòng gated:
1. Feedback loop đỏ với ĐÚNG bug này (reproduce trước, luôn luôn)
2. Thu nhỏ repro
3. Giả thuyết (mỗi lần một cái)
4. Instrument để confirm hoặc giết giả thuyết
5. Fix
6. Regression test để không quay lạitextKhông nhảy tới bước 5. Gate nào cũng phải pass mới mở gate sau.
4. Review và ship: hai trục#
/code-review chạy hai trục bằng subagent song song để không nhiễm nhau:
- Standards — chuẩn repo cộng Fowler smell baseline
- Spec — trung thành với issue/spec gốc?
Rồi /pr nặn body: summary visual nhỏ nhất, evidence before/after, merge-danger call (cửa một chiều hay hai chiều, blast radius).
5. Kiến trúc: survey, không phải rescue#
Entropy tăng tốc ở tốc độ agent. Hai tool:
/to-spechỏi bạn đụng module nào trước khi spec/improve-codebase-architecturesurvey deepening opportunity (deep module kiểu Ousterhout: behavior nhiều, interface nhỏ) thành báo cáo HTML visual, rồi grill cái bạn chọn
Chạy vài ngày một lần. Scope trung thực: code cũ thật thì tìm được candidate nhưng không gỡ mud hộ bạn.
Ví dụ thực tế: từ bug tới xanh#
/grill-with-docs # "checkout retry" — thống nhất: retry là re-enqueue, max 3, bắt buộc idempotency key
/to-tickets # slice 1: plumbing key; slice 2: retry policy; slice 3: UI state
/implement # TDD mỗi slice ở seam đã hẹn
# lòi bug: retry charge trùng
# /diagnosing-bugs: repro đỏ → thu nhỏ → giả thuyết (key không propagate) → instrument → fix → regression test
# /code-review rồi /prtextKiểm soát cost#
Skill là text và process — cost nằm ở grilling dài, scan kiến trúc, decomposition, đọc lặp. Kiểm soát: skill hẹp mỗi task (một bug, một slice, một plan, /handoff để nén chuyển context).
Kết luận#
Grill mọi change, test từng slice, diagnose gated, review hai trục. Kỷ luật, không phải magic — thinking baked in mới là giá trị.