| name | receiving-code-review |
| description (EN) | Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation |
| 說明 (繁中) | 當收到程式碼審查回饋、在實作建議之前使用,尤其是當回饋看起來不清楚或技術上有疑慮時 —— 需要技術嚴謹與驗證,而不是做作地附和或盲目實作 |
Code review requires technical evaluation, not emotional performance.
程式碼審查需要技術評估,而不是情緒表演。
Core principle: Verify before implementing. Ask before assuming. Technical correctness over social comfort.
核心原則: 先驗證再實作。先詢問再臆測。技術正確性優先於社交舒適感。
WHEN receiving code review feedback:
1. READ: Complete feedback without reacting
2. UNDERSTAND: Restate requirement in own words (or ask)
3. VERIFY: Check against codebase reality
4. EVALUATE: Technically sound for THIS codebase?
5. RESPOND: Technical acknowledgment or reasoned pushback
6. IMPLEMENT: One item at a time, test each
WHEN receiving code review feedback:
1. READ: Complete feedback without reacting
2. UNDERSTAND: Restate requirement in own words (or ask)
3. VERIFY: Check against codebase reality
4. EVALUATE: Technically sound for THIS codebase?
5. RESPOND: Technical acknowledgment or reasoned pushback
6. IMPLEMENT: One item at a time, test each
NEVER: - "You're absolutely right!" (explicit instruction-file violation) - "Great point!" / "Excellent feedback!" (performative) - "Let me implement that now" (before verification)
絕不: - 「你完全正確!」(明確違反指令檔) - 「好觀點!」/「優秀的回饋!」(做作) - 「我現在就來實作」(在驗證之前)
INSTEAD: - Restate the technical requirement - Ask clarifying questions - Push back with technical reasoning if wrong - Just start working (actions > words)
取而代之: - 複述技術需求 - 提出釐清問題 - 如果錯誤,用技術論證提出異議 - 直接動手做(行動勝於言語)
IF any item is unclear:
STOP - do not implement anything yet
ASK for clarification on unclear items
WHY: Items may be related. Partial understanding = wrong implementation.
IF any item is unclear:
STOP - do not implement anything yet
ASK for clarification on unclear items
WHY: Items may be related. Partial understanding = wrong implementation.
Example: ``` your human partner: "Fix 1-6" You understand 1,2,3,6. Unclear on 4,5.
範例: ``` your human partner: "Fix 1-6" You understand 1,2,3,6. Unclear on 4,5.
❌ WRONG: Implement 1,2,3,6 now, ask about 4,5 later ✅ RIGHT: "I understand items 1,2,3,6. Need clarification on 4 and 5 before proceeding." ```
❌ WRONG: Implement 1,2,3,6 now, ask about 4,5 later ✅ RIGHT: "I understand items 1,2,3,6. Need clarification on 4 and 5 before proceeding." ```
``` BEFORE implementing: 1. Check: Technically correct for THIS codebase? 2. Check: Breaks existing functionality? 3. Check: Reason for current implementation? 4. Check: Works on all platforms/versions? 5. Check: Does reviewer understand full context?
``` BEFORE implementing: 1. Check: Technically correct for THIS codebase? 2. Check: Breaks existing functionality? 3. Check: Reason for current implementation? 4. Check: Works on all platforms/versions? 5. Check: Does reviewer understand full context?
IF suggestion seems wrong: Push back with technical reasoning
IF suggestion seems wrong: Push back with technical reasoning
IF can't easily verify: Say so: "I can't verify this without [X]. Should I [investigate/ask/proceed]?"
IF can't easily verify: Say so: "I can't verify this without [X]. Should I [investigate/ask/proceed]?"
IF conflicts with your human partner's prior decisions: Stop and discuss with your human partner first ```
IF conflicts with your human partner's prior decisions: Stop and discuss with your human partner first ```
your human partner's rule: "External feedback - be skeptical, but check carefully"
你的人工夥伴的規則: 「外部回饋 - 保持懷疑,但要仔細檢查」
IF reviewer suggests "implementing properly":
grep codebase for actual usage
IF unused: "This endpoint isn't called. Remove it (YAGNI)?"
IF used: Then implement properly
IF reviewer suggests "implementing properly":
grep codebase for actual usage
IF unused: "This endpoint isn't called. Remove it (YAGNI)?"
IF used: Then implement properly
your human partner's rule: "You and reviewer both report to me. If we don't need this feature, don't add it."
你的人工夥伴的規則: 「你與審查者都向我匯報。如果我們不需要這個功能,就不要加。」
FOR multi-item feedback:
1. Clarify anything unclear FIRST
2. Then implement in this order:
- Blocking issues (breaks, security)
- Simple fixes (typos, imports)
- Complex fixes (refactoring, logic)
3. Test each fix individually
4. Verify no regressions
FOR multi-item feedback:
1. Clarify anything unclear FIRST
2. Then implement in this order:
- Blocking issues (breaks, security)
- Simple fixes (typos, imports)
- Complex fixes (refactoring, logic)
3. Test each fix individually
4. Verify no regressions
Push back when: - Suggestion breaks existing functionality - Reviewer lacks full context - Violates YAGNI (unused feature) - Technically incorrect for this stack - Legacy/compatibility reasons exist - Conflicts with your human partner's architectural decisions
在以下情況提出異議: - 建議會破壞現有功能 - 審查者缺乏完整上下文 - 違反 YAGNI(未使用的功能) - 對這個技術棧來說技術上不正確 - 存在舊版/相容性理由 - 與你的人工夥伴的架構決策衝突
How to push back: - Use technical reasoning, not defensiveness - Ask specific questions - Reference working tests/code - Involve your human partner if architectural
如何提出異議: - 用技術論證,而不是防衛心態 - 提出具體問題 - 引用能運作的測試/程式碼 - 如果是架構層級的問題,讓人工夥伴參與
If you're uncomfortable pushing back out loud: Name that tension, then tell your partner about the issue you've seen. They'll appreciate your honesty.
如果你對公開提出異議感到不自在: 說出那個張力,然後把你看見的問題告訴你的夥伴。他們會感謝你的誠實。
When feedback IS correct: ``` ✅ "Fixed. [Brief description of what changed]" ✅ "Good catch - [specific issue]. Fixed in [location]." ✅ [Just fix it and show in the code]
當回饋確實正確時: ``` ✅ "Fixed. [Brief description of what changed]" ✅ "Good catch - [specific issue]. Fixed in [location]." ✅ [Just fix it and show in the code]
❌ "You're absolutely right!" ❌ "Great point!" ❌ "Thanks for catching that!" ❌ "Thanks for [anything]" ❌ ANY gratitude expression ```
❌ "You're absolutely right!" ❌ "Great point!" ❌ "Thanks for catching that!" ❌ "Thanks for [anything]" ❌ ANY gratitude expression ```
Why no thanks: Actions speak. Just fix it. The code itself shows you heard the feedback.
為什麼不道謝: 行動勝於言語。直接修好它。程式碼本身就會顯示你聽見了回饋。
If you catch yourself about to write "Thanks": DELETE IT. State the fix instead.
如果你發現自己正要打出「Thanks」: 刪掉它。改為陳述修正。
If you pushed back and were wrong: ``` ✅ "You were right - I checked [X] and it does [Y]. Implementing now." ✅ "Verified this and you're correct. My initial understanding was wrong because [reason]. Fixing."
如果你提出異議但錯了: ``` ✅ "You were right - I checked [X] and it does [Y]. Implementing now." ✅ "Verified this and you're correct. My initial understanding was wrong because [reason]. Fixing."
❌ Long apology ❌ Defending why you pushed back ❌ Over-explaining ```
❌ Long apology ❌ Defending why you pushed back ❌ Over-explaining ```
State the correction factually and move on.
如實陳述修正並繼續前進。
| Mistake | Fix |
|---|---|
| Performative agreement | State requirement or just act |
| Blind implementation | Verify against codebase first |
| Batch without testing | One at a time, test each |
| Assuming reviewer is right | Check if breaks things |
| Avoiding pushback | Technical correctness > comfort |
| Partial implementation | Clarify all items first |
| Can't verify, proceed anyway | State limitation, ask for direction |
| 錯誤 | 修正 |
|---|---|
| 做作地附和 | 陳述需求或直接行動 |
| 盲目實作 | 先對照程式碼現況驗證 |
| 一次大量修改未測試 | 一次一項,逐項測試 |
| 預設審查者一定對 | 檢查是否破壞其他東西 |
| 迴避提出異議 | 技術正確性 > 舒適感 |
| 部分實作 | 先釐清所有項目 |
| 無法驗證卻繼續進行 | 說明限制,請示方向 |
Performative Agreement (Bad):
Reviewer: "Remove legacy code"
❌ "You're absolutely right! Let me remove that..."
做作地附和(不良):
Reviewer: "Remove legacy code"
❌ "You're absolutely right! Let me remove that..."
Technical Verification (Good):
Reviewer: "Remove legacy code"
✅ "Checking... build target is 10.15+, this API needs 13+. Need legacy for backward compat. Current impl has wrong bundle ID - fix it or drop pre-13 support?"
技術驗證(良好):
Reviewer: "Remove legacy code"
✅ "Checking... build target is 10.15+, this API needs 13+. Need legacy for backward compat. Current impl has wrong bundle ID - fix it or drop pre-13 support?"
YAGNI (Good):
Reviewer: "Implement proper metrics tracking with database, date filters, CSV export"
✅ "Grepped codebase - nothing calls this endpoint. Remove it (YAGNI)? Or is there usage I'm missing?"
YAGNI(良好):
Reviewer: "Implement proper metrics tracking with database, date filters, CSV export"
✅ "Grepped codebase - nothing calls this endpoint. Remove it (YAGNI)? Or is there usage I'm missing?"
Unclear Item (Good):
your human partner: "Fix items 1-6"
You understand 1,2,3,6. Unclear on 4,5.
✅ "Understand 1,2,3,6. Need clarification on 4 and 5 before implementing."
不清楚的項目(良好):
your human partner: "Fix items 1-6"
You understand 1,2,3,6. Unclear on 4,5.
✅ "Understand 1,2,3,6. Need clarification on 4 and 5 before implementing."
When replying to inline review comments on GitHub, reply in the comment thread (gh api repos/{owner}/{repo}/pulls/{pr}/comments/{id}/replies), not as a top-level PR comment.
回覆 GitHub 上的行內審查意見時,請在該意見的討論串中回覆(gh api repos/{owner}/{repo}/pulls/{pr}/comments/{id}/replies),而不是在 PR 頂層加一則留言。