receiving-code-review

Tổng quan

Kỹ năng receiving-code-review làm gì

Kỹ năng receiving-code-review định nghĩa một mẫu hành vi rõ ràng, lặp lại được cho cách một agent nên phản hồi khi nhận được phản hồi code review, đặc biệt là trên GitHub pull request. Trọng tâm là đánh giá kỹ thuật hơn là thể hiện xã giao.

Thay vì gật đầu đồng ý vô thức với reviewer hoặc lập tức triển khai mọi gợi ý, kỹ năng này hướng dẫn agent:

• Đọc toàn bộ phản hồi trước khi đáp lại
• Nhắc lại hoặc làm rõ yêu cầu thay đổi
• Đối chiếu phản hồi với codebase thực tế
• Đánh giá xem gợi ý đó có đúng về mặt kỹ thuật với repository này không
• Phản hồi bằng lập luận kỹ thuật vững chắc, không phải lời khen xã giao
• Thực hiện các thay đổi từng mục một, chỉ sau khi đã hiểu và kiểm chứng

Kỹ năng này dành cho ai

Hãy dùng receiving-code-review nếu bạn:

• Làm việc với AI assistant trên GitHub PR hoặc các cuộc thảo luận code review
• Muốn assistant hành xử như một reviewer/reviewee biết suy nghĩ, không chỉ gật đầu đồng ý
• Cần hỗ trợ diễn giải comment review và quyết định bước tiếp theo
• Ưu tiên tính đúng đắn và an toàn của thay đổi hơn là đồng ý nhanh nhưng hời hợt

Đặc biệt hữu ích cho:

• Developer cộng tác trên feature branch và pull request
• Tech lead muốn xử lý phản hồi review một cách nhất quán
• Các team đang thử nghiệm Claude hoặc các LLM khác như đối tác review PR

Khi nào kỹ năng này không phù hợp

Kỹ năng này không được thiết kế cho:

• Sinh tính năng mới từ con số 0
• Refactor quy mô lớn mà không có ngữ cảnh review
• Các câu xã giao, khen ngợi, hay cập nhật trạng thái

Nếu nhu cầu chính của bạn là sinh code, soạn tài liệu, hoặc hỗ trợ thiết kế ở mức cao, hãy kết hợp kỹ năng này với các kỹ năng khác. Hãy dùng receiving-code-review cụ thể khi agent đang ở trong vòng lặp nhận và phản hồi phản hồi code review.

Lợi ích chính

Khi cài receiving-code-review, agent của bạn sẽ:

• Tránh các câu trả lời trình diễn như "You're absolutely right!" hoặc "Great point!"
• Dựa trên code thực tế để phản hồi, không dựa vào suy đoán
• Hỏi lại để làm rõ thay vì đoán khi phản hồi chưa rõ ràng
• Phản biện một cách tôn trọng khi gợi ý không đúng về mặt kỹ thuật
• Giảm nguy cơ triển khai các thay đổi hiểu nhầm hoặc gây hại

Điều này giúp bạn dễ tin tưởng agent hơn trong các quy trình code-review, git-workflows và pr-review.

Cách sử dụng

1. Cài đặt

Để cài kỹ năng receiving-code-review từ repository obra/superpowers, chạy:

npx skills add https://github.com/obra/superpowers --skill receiving-code-review

Lệnh này sẽ kéo định nghĩa kỹ năng (bao gồm SKILL.md) vào môi trường kỹ năng của agent. Việc cài đặt giả định bạn đã có sẵn bộ công cụ npx skills; nếu chưa, hãy thiết lập trước theo hướng dẫn của nền tảng hoặc host của agent.

2. File cần xem sau khi cài

Sau khi cài đặt, hãy xem file cốt lõi cho kỹ năng này:

• skills/receiving-code-review/SKILL.md – mô tả chuẩn về mẫu hành vi khi nhận phản hồi code review.

Trong repo obra/superpowers rộng hơn bạn có thể thấy các mẫu chia sẻ như:

• README.md, AGENTS.md hoặc metadata.json ở thư mục gốc – bối cảnh chung về cách tổ chức và sử dụng kỹ năng

Những file này giúp bạn hiểu receiving-code-review nằm ở đâu trong bộ quy tắc Claude/agent lớn hơn, nhưng phần vận hành trọng tâm của kỹ năng nằm trong SKILL.md.

3. Quy trình phản hồi cốt lõi

Kỹ năng này định nghĩa một mẫu phản hồi cụ thể mỗi khi agent nhận được phản hồi code review (ví dụ, trong một chuỗi comment trên GitHub PR):

1. READ:     Consume all feedback before reacting
2. UNDERSTAND: Restate the requirement in its own words, or ask
3. VERIFY:   Check the feedback against the real codebase
4. EVALUATE: Decide if it is technically sound for THIS repo
5. RESPOND:  Give a technical acknowledgment or reasoned pushback
6. IMPLEMENT: Change one item at a time and test each

Trong thực tế, điều này nghĩa là:

• Agent không nên lập tức nói sẽ triển khai ngay gợi ý.
• Trước tiên nó phải đảm bảo hiểu rõ reviewer đang yêu cầu gì.
• Nó kiểm tra các file/dòng liên quan hoặc trạng thái repository.
• Chỉ sau đó mới quyết định áp dụng, điều chỉnh hay từ chối gợi ý.

Mẫu này đặc biệt hữu ích trong các tình huống GitHub pull request review, nơi ngữ cảnh và độ chính xác quan trọng hơn tốc độ.

4. Các kiểu phản hồi bị cấm hoặc không khuyến khích

Kỹ năng này cấm rõ ràng một số kiểu phản hồi thường gặp ở LLM nhưng gây hại trong code review nghiêm túc:

Ví dụ bị cấm:

• "You're absolutely right!" (được đánh dấu rõ ràng là vi phạm các quy tắc CLAUDE mức cao hơn)
• "Great point!" / "Excellent feedback!" và các kiểu chỉ toàn khen ngợi tương tự
• "Let me implement that now" khi agent chưa kiểm chứng gợi ý

Thay vào đó, khi dùng receiving-code-review, agent nên:

• Nhắc lại yêu cầu kỹ thuật: ví dụ "You are asking to extract this logic into a separate function to avoid duplication."
• Đặt các câu hỏi cụ thể khi có điểm chưa rõ
• Đưa ra lập luận kỹ thuật khi cho rằng gợi ý chưa đúng hoặc chưa đủ
• Tiến tới thay đổi thực tế mà không sa đà giải thích dài dòng hay khen ngợi

Cách này giữ cho cuộc trao đổi tập trung vào chất lượng code, không phải lời nịnh.

5. Xử lý phản hồi mơ hồ hoặc không đầy đủ

Kỹ năng đặt ra một quy tắc nghiêm ngặt cho phản hồi mơ hồ:

IF any item in the feedback is unclear:
  STOP – do not implement anything yet
  ASK for clarification on the unclear items

Lý do: từng mục review có thể liên quan với nhau, nên nếu triển khai những mục mà bạn "nghĩ" là hiểu trong khi các mục khác vẫn mơ hồ có thể dẫn đến:

• Các thay đổi xung đột
• Quy trình bị phá vỡ
• Hành vi hệ thống lệch khỏi ý định của reviewer

Ví dụ, nếu một reviewer nói "Fix 1–6" và agent chỉ hiểu các mục 1, 2, 3 và 6, receiving-code-review hướng dẫn nó:

• Tạm dừng việc triển khai
• Hỏi các câu hỏi làm rõ cụ thể về mục 4 và 5
• Chỉ triển khai sau khi đã hiểu trọn vẹn toàn bộ yêu cầu

Hành vi này rất quan trọng trong các workflow git tự động hoặc bán tự động, nơi hiểu nhầm một phần có thể nhanh chóng biến thành nhánh bị hỏng.

6. Tích hợp với workflow GitHub / PR của bạn

Để tận dụng tối đa receiving-code-review trong dự án thực tế:

1. Gắn kỹ năng này vào agent bạn dùng để:

   • Review pull request
   • Soạn thảo phản hồi cho comment của reviewer
   • Hỗ trợ phân loại hoặc tóm tắt phản hồi review

2. Đảm bảo agent có quyền truy cập repository để thực sự kiểm chứng gợi ý với:

   • Code của branch hiện tại
   • Các file và module liên quan

3. Kết hợp với các kỹ năng bổ trợ để có kết quả tốt nhất, chẳng hạn:

   • Kỹ năng coding hoặc refactor để triển khai các thay đổi đã thống nhất
   • Kỹ năng điều hướng hoặc tìm kiếm trong repository để nhanh chóng định vị vùng code bị ảnh hưởng

4. Thông tin cho team của bạn rằng agent sẽ:

   • Đặt câu hỏi làm rõ thay vì đoán
   • Đôi khi phản biện lại các gợi ý sai hoặc rủi ro
   • Tránh lời khen chung chung, ưu tiên phản hồi kỹ thuật cụ thể

Khi được tích hợp theo cách này, receiving-code-review trở thành một “lan can” giúp cộng tác viên AI của bạn giữ kỷ luật và đáng tin cậy trong các cuộc trao đổi code review.

7. Khi nào nên kích hoạt kỹ năng này

Hãy dùng receiving-code-review bất cứ khi nào prompt hoặc workflow cho thấy agent đang:

• Đọc phản hồi từ người hoặc bot trên một pull request
• Duyệt qua inline comment trong GitHub diff view
• Xử lý ghi chú review trong một công cụ code-review

Bạn thường không cần kỹ năng này khi:

• Sinh code ban đầu hoặc bản nháp đầu tiên của một tính năng
• Viết tài liệu thiết kế hoặc ADR
• Thực hiện các tác vụ ngoài review như nâng cấp dependency

Chỉ kích hoạt kỹ năng trong ngữ cảnh review sẽ giúp hành vi agent dễ dự đoán và tập trung hơn.

FAQ

receiving-code-review giải quyết vấn đề gì?

Kỹ năng receiving-code-review giải quyết vấn đề các phản hồi code review hời hợt, mang tính trình diễn của AI. Thay vì luôn đồng ý và lập tức sửa code, agent sẽ:

• Đọc toàn bộ phản hồi
• Đối chiếu với codebase hiện có
• Làm rõ các yêu cầu mơ hồ
• Phản biện bằng lập luận kỹ thuật khi cần thiết

Nhờ đó, số lượng triển khai sai và hiểu nhầm trong GitHub PR và các công cụ code-review khác giảm đáng kể.

Tôi cài receiving-code-review như thế nào?

Cài kỹ năng từ repository obra/superpowers bằng lệnh:

npx skills add https://github.com/obra/superpowers --skill receiving-code-review

Sau khi cài, hãy xem SKILL.md trong thư mục kỹ năng receiving-code-review để nắm rõ các quy tắc hành vi cụ thể.

Kỹ năng này có làm thay đổi cách viết code không?

Có, nhưng gián tiếp. receiving-code-review không tự sinh code, nhưng ảnh hưởng mạnh đến cách và thời điểm thực hiện thay đổi code bằng cách buộc phải:

• Kiểm chứng trước khi triển khai
• Thay đổi và test theo từng mục
• Tránh các bản sửa chữa nửa vời, hiểu chưa đúng

Hãy kết hợp với các kỹ năng coding để xử lý phần triển khai thực tế sau khi phản hồi review đã được xác thực.

receiving-code-review có thể phản biện lại reviewer là người không?

Có. Kỹ năng này cho phép và khuyến khích phản biện kỹ thuật có lý lẽ khi phản hồi:

• Không đúng với codebase hiện tại
• Dựa trên giả định đã lỗi thời
• Có nguy cơ gây lỗi hoặc regression

Sự phản biện phải dựa trên chi tiết cụ thể trong repository, không phải ý kiến cảm tính.

Kỹ năng này chỉ dùng cho GitHub thôi à?

Kỹ năng được viết với workflow PR review kiểu GitHub làm chuẩn, nhưng có thể áp dụng ở bất cứ môi trường nào mà agent nhận phản hồi code review có cấu trúc, bao gồm:

• Các công cụ code review dựa trên git
• Dashboard review nội bộ
• Các phiên review qua chat nơi comment tham chiếu đến file và dòng cụ thể

Nếu workflow của bạn giống mô hình comment PR + repository git, receiving-code-review sẽ phù hợp.

Kỹ năng này tương tác với CLAUDE hoặc các quy tắc agent khác thế nào?

Trong hệ sinh thái obra/superpowers, các kỹ năng được xếp lớp với các quy tắc cấp cao hơn (thường nằm trong các file như CLAUDE.md). receiving-code-review tham chiếu các kỳ vọng đó bằng cách cấm các phản hồi như "You're absolutely right!" vốn đi ngược tinh thần những quy tắc này.

Hãy dùng kỹ năng này song song với bộ quy tắc agent hiện tại để:

• Siết chặt hành vi trong code review
• Tránh tối ưu hoá về mặt xã giao quá mức
• Duy trì tính nhất quán trên nhiều dự án và repository

Nếu team tôi thích phản hồi lịch sự hơn thì sao?

Bạn vẫn có thể giữ giọng điệu chuyên nghiệp, nhưng kỹ năng này ưu tiên giao tiếp kỹ thuật rõ ràng hơn là các công thức lịch sự. Nếu cần giọng điệu mềm hơn, bạn có thể:

• Thêm hướng dẫn riêng về tone trong các kỹ năng khác
• Giữ receiving-code-review làm khung xương cho việc kiểm chứng và tính nghiêm túc

Cách tách biệt này cho phép điều chỉnh phong cách mà không làm yếu đi kỷ luật review cốt lõi.

Làm sao biết kỹ năng này hoạt động đúng?

Các dấu hiệu cho thấy receiving-code-review đang hoạt động hiệu quả gồm:

• Agent không còn trả lời bằng các câu khen chung chung cho comment review
• Nó nhắc lại yêu cầu trước khi hành động
• Nó đặt câu hỏi khi phản hồi chưa đầy đủ hoặc mơ hồ
• Nó tham chiếu đến file, hàm hoặc dòng cụ thể khi chấp nhận hoặc phản biện gợi ý

Nếu bạn vẫn thấy các câu trả lời kiểu "I’ll implement that" ngay lập tức mà không có bước kiểm chứng, hãy xem lại cấu hình kỹ năng và chắc chắn kỹ năng này đã được bật trong ngữ cảnh review.