概觀
receiving-code-review 技能的功能
receiving-code-review 技能為代理（agent）在收到程式碼審查回饋時，定義了一套清楚且可重複的回應模式，特別是針對 GitHub pull requests。重點在於 技術評估優先於社交表現。
這個技能避免代理機器人對審查者盲目附和或立刻實作建議，而是訓練代理去：
- 在反應前先完整閱讀所有回饋
- 轉述或釐清對方要求的變更
- 將回饋對照實際程式碼庫驗證
- 評估建議在這個 repository 中是否技術上合理
- 以具體技術推理來回應，而不是恭維
- 在理解並驗證後，逐項實作變更
適用對象
在以下情境請使用 receiving-code-review：
- 你在 GitHub PR 或程式碼審查討論中使用 AI 助理
- 你希望助理扮演認真思考的 reviewer 或被審查者，而不是一味答應
- 你需要協助解讀審查意見並決定下一步該做什麼
- 你更在乎修改的正確性與安全性，而不是快速但流於表面的同意
特別適合：
- 在 feature branches 與 pull requests 上協作的開發者
- 希望穩定、一致處理審查回饋的技術主管
- 正在試驗使用 Claude 或其他 LLM 當 PR 審查夥伴的團隊
什麼情況下不適合使用這個技能
這個技能 不 是為以下用途設計的：
- 從零開始產生新功能
- 在沒有審查脈絡的大型重構
- 社交寒暄、讚美或狀態更新
如果你的主要需求是程式碼產生、文件撰寫或高階設計協助，請搭配其他技能使用。將 receiving-code-review 只用在代理參與 接收並回應程式碼審查回饋 的環節。
主要優點
安裝 receiving-code-review 後，你的代理將會：
- 避免像「You're absolutely right!」或「Great point!」這類表演式回覆
- 以實際程式碼為基礎，而不是憑想像回應
- 在回饋不清楚時詢問釐清，而不是亂猜
- 在建議技術上有問題時禮貌但堅定地說明理由
- 降低因誤解或錯誤實作而導致問題變更的風險
這能讓你更放心地在 code-review、git-workflows、pr-review 流程中使用代理。
使用方式
1. 安裝
要從 obra/superpowers repository 安裝 receiving-code-review 技能，執行：
npx skills add https://github.com/obra/superpowers --skill receiving-code-review
這會把技能定義（包含 SKILL.md）拉進你的代理技能環境。安裝前預設你已具備 npx skills 工具；若尚未安裝，請先依照你的平台或代理主機的說明完成設定。
2. 安裝後要檢視的檔案
安裝完成後，請先檢查這個技能的核心檔案：
skills/receiving-code-review/SKILL.md– 當收到程式碼審查回饋時，行為模式的權威說明文件。
在較大的 obra/superpowers repo 中，你也可能看到共用模式檔案，例如：
- root 底下的
README.md、AGENTS.md或metadata.json– 說明技能整體結構與用法的通用背景
這些有助於理解 receiving-code-review 如何融入更大的 Claude／代理規則集，但此技能實際執行心臟仍在 SKILL.md。
3. 核心回應流程
此技能針對代理每次收到程式碼審查回饋（例如 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
實務上代表：
- 代理不應一收到建議就立刻說要實作。
- 它會先確認自己是否理解 reviewer 的需求。
- 它會查看相關檔案／行數或 repository 狀態。
- 之後才決定要直接採用、調整或拒絕該建議。
這種模式特別適合 GitHub pull request review 情境，在那裡脈絡與正確性比速度更重要。
4. 禁用與不建議的回應
此技能明確禁止某些在 LLM 中常見、但在嚴肅程式碼審查裡有害的回應類型：
禁止範例：
"You're absolutely right!"（在較高層的 CLAUDE 規則中被明確指出為違規）"Great point!"／"Excellent feedback!"這類純讚美式回應"Let me implement that now"當代理尚未驗證建議即宣稱要執行
使用 receiving-code-review 時，代理應該改為：
- 重新陳述技術需求：例如「You are asking to extract this logic into a separate function to avoid duplication.」
- 在不清楚時提出具體問題
- 在認為建議不正確或不完整時，提供清楚的技術理由
- 實際往修改前進，但不需要過度解釋或過度稱讚
這能讓對話聚焦在程式碼品質，而非恭維。
5. 處理不清楚或部分回饋
此技能對於模糊回饋訂有嚴格規則：
IF any item in the feedback is unclear:
STOP – do not implement anything yet
ASK for clarification on the unclear items
理由是：個別審查項目可能彼此相關，如果在部分內容仍然模糊時，只先實作「自以為」理解的幾項，容易導致：
- 互相衝突的修改
- 中斷原有流程
- 行為與 reviewer 的真正意圖產生落差
例如，reviewer 說「Fix 1–6」，但代理只理解了 1、2、3 和 6，receiving-code-review 會指引它：
- 暫停實作
- 針對第 4、5 項提出明確釐清問題
- 等到整組需求都理解後才開始實作
這在自動或半自動的 git 工作流程中特別重要，因為片面理解很容易演變成壞掉的 branches。
6. 與 GitHub／PR 工作流程整合
要在真實專案中最大化 receiving-code-review 的效果：
-
把技能掛載到你的代理，用在：
- 審查 pull requests
- 撰寫回覆 reviewer 留言
- 協助整理與分類審查回饋
-
確保代理有 repository 存取權，才能真的把建議與下列內容比對：
- 目前 branch 的程式碼
- 相關檔案與模組
-
搭配其他互補技能 以取得最佳效果，例如：
- 用來實作已同意變更的 coding 或 refactoring 技能
- 幫助快速定位受影響程式碼的 repository navigation 或 search 技能
-
讓團隊知道代理的行為模式，包括它會：
- 在不確定時發問，而不是硬猜
- 在建議有錯或風險時適度提出異議
- 避免泛泛的讚美，而偏好具體技術回饋
在這樣的整合下，receiving-code-review 會成為一條護欄，讓你的 AI 協作者在程式碼審查對話中維持紀律與可信度。
7. 何時啟用這個技能
在以下情境請啟用 receiving-code-review：
- 代理正在閱讀人類或機器人的 pull request 回饋
- 瀏覽 GitHub diff 檢視中的 inline comments
- 處理程式碼審查工具中的 review notes
通常 不 需要在這些情境啟用：
- 產出初版程式碼或功能草稿
- 撰寫設計文件或 ADRs
- 執行非審查任務，例如 dependency upgrades
只在審查情境啟用此技能，可讓代理的行為更可預期且專注。
常見問題
receiving-code-review 解決了什麼問題？
receiving-code-review 主要解決 AI 在面對程式碼審查回饋時，容易流於表面、敷衍式回應的問題。代理不再是逢人就說好、立刻改碼，而是會：
- 先完整閱讀所有回饋
- 與既有程式碼庫比對驗證
- 釐清模糊要求
- 在必要時，以技術理由提出異議
這大幅降低 GitHub PR 及其他程式碼審查工具中，錯誤實作與溝通誤解的機率。
我要如何安裝 receiving-code-review？
從 obra/superpowers repository 安裝技能：
npx skills add https://github.com/obra/superpowers --skill receiving-code-review
安裝後，請閱讀 receiving-code-review 技能目錄下的 SKILL.md，了解完整的行為規則。
這個技能會改變程式碼寫法嗎？
算是間接改變。receiving-code-review 本身不會產生程式碼，但會透過以下方式強烈影響程式碼 如何 以及 何時 被修改：
- 先驗證再實作
- 逐項修改並逐項測試
- 避免半知半解的修正
請搭配 coding 技能，在回饋已被驗證後，交由其他技能負責實際實作。
receiving-code-review 會對人類 reviewer 提出異議嗎？
會。當回饋：
- 與目前程式碼庫實況不符
- 建立在過時的假設上
- 可能導致 bug 或 regression
此技能明確允許且鼓勵代理提出有理有據、以技術為基礎的反駁。這些回應必須建立在 repository 中具體細節上，而不是主觀意見。
這個技能只適用於 GitHub 嗎？
此技能是以 GitHub 式的 PR review 工作流程為設計出發點，但也適用於任何代理會接收結構化程式碼審查回饋的環境，包括：
- 各種基於 git 的程式碼審查工具
- 內部審查儀表板
- 在聊天介面內進行、會引用特定檔案與行數的審查對話
只要你的流程類似「PR 評論 + git repository」，receiving-code-review 通常都很適合。
它如何與 CLAUDE 或其他代理規則互動？
在 obra/superpowers 生態系中，技能會與更高層的規則（通常寫在像 CLAUDE.md 這樣的檔案中）疊加使用。receiving-code-review 會呼應這些期待，例如明確禁止「You're absolutely right!」這種違背規則精神的回覆。
請將它與你現有的代理規則一起使用，以：
- 強化審查時的行為紀律
- 避免過度追求社交表現
- 在不同專案與 repositories 間維持一致性
如果我們團隊偏好更客氣的回應怎麼辦？
你仍然可以維持專業且有禮貌的語氣，但此技能優先確保 技術溝通清楚，而不是禮貌套話。如果你需要更柔和的措辭，可以：
- 在其他技能中加入額外的語氣與風格指引
- 保留 receiving-code-review 作為驗證與嚴謹性的核心骨幹
這樣能讓你在不削弱審查紀律的前提下，彈性調整表達風格。
我要怎麼判斷這個技能是否正常運作？
下面的跡象通常代表 receiving-code-review 已啟用且運作良好：
- 代理不再對審查留言只用制式讚美回覆
- 它會在採取行動前先重新陳述需求
- 當回饋不完整或含糊時，它會主動提問
- 在接受或質疑建議時，會引用具體檔案、函式或行數
如果你仍常看到「I’ll implement that」這種一收到建議就要實作、卻沒有任何驗證步驟的回覆，請重新檢查技能設定，確認在審查情境中已確實啟用此技能。