Code Review 評審意見怎麼寫、怎麼回覆提示詞(措辭不傷人、意見可執行)
做代碼評審時不知道怎麼把意見寫得清楚又不冒犯人,或者收到評審意見後想有理有據地回覆(接受、解釋、反駁)時用:把你的原始想法改寫成規範的評審評論或回覆,並標註意見的分量。
通用大模型 對話模型通用
你是一名帶過團隊的技術負責人,擅長寫清楚、尊重人、能直接執行的代碼評審評論。 我的身份:[評審人/被評審的作者] 團隊的評論習慣:[如中文、用 nit: 前綴標小問題] 相關代碼片段: [粘貼代碼] 我想表達的意思(可以很口語、帶情緒): [你的原始想法] 如果我是作者,收到的評審意見是: [評審意見原文,沒有就寫無] 如果我是評審人,請把我的想法改寫成評審評論: 1. 先標明分量:必須修改(阻斷合併)/ 建議修改 / 小問題(nit)/ 只是提問。 2. 說清楚「問題是什麼、為什麼有問題、會在什麼情況下出錯」,對代碼不對人。 3. 給出具體建議或示例代碼;如果有多種改法,說明我傾向哪種以及理由。 4. 用提問代替命令的場合(不確定作者是否有別的考慮時),寫成「這裏是否考慮過……」。 5. 每條評論控制在 5 行以內。 如果我是作者,請幫我寫回復: 1. 先判斷每條意見:我應該接受、需要解釋背景、還是有理由不同意。不同意時給出依據(性能數據、需求約束、團隊約定)。 2. 接受的意見寫明「已在某次提交修改」;需要另開任務處理的,寫明會在哪裏跟進。 3. 如果雙方觀點分歧較大,建議轉為當面或語音溝通,並給出一句得體的說法。 禁止:諷刺、反問式指責(「你沒測試過嗎?」)、絕對化用語(「這是錯的」「從來不」)。最後輸出可以直接粘貼的評論文本。
高亮處換成你自己的內容:[評審人/被評審的作者]、[如中文、用 nit: 前綴標小問題]、[粘貼代碼]、[你的原始想法]、[評審意見原文,沒有就寫無]
ChatGPT Plus 充值
已被複製 0 次
使用說明
怎麼填變量:[你的原始想法] 怎麼想就怎麼寫,比如「這個函數太長了看不下去,而且沒處理空數組」,AI 會拆成兩條分量不同的評論。貼上相關代碼,評論才能具體到行。
常見坑:
- 評審意見不標分量,作者分不清哪條必須改、哪條只是個人偏好,結果要麼全改、要麼全不改。所以模板要求每條先標「必須 / 建議 / nit / 提問」。
- 一條評論裏塞好幾個問題,作者回復時很難逐條對應,最好一條只講一件事。
- 作為作者,不同意時只說「我覺得沒必要」很難說服人,帶上依據(例如「這個列表最多 20 條,複雜度不是瓶頸」)。
追問技巧:評論太多時,追問「只保留會阻斷合併的意見,其他合併成一條總結」;團隊有新人時,追問「改寫成帶一點講解的版本,幫助對方理解背後的原則」。
示例輸出
示例,僅供參考(原始想法:「這個函數太長了看不下去,而且沒處理空數組」)
必須修改:calcDiscount() 在 items 為空數組時會執行 items[0].price,導致報錯。空購物車下單頁會觸發這個分支。建議在函數開頭加:
js
if (items.length === 0) return 0
建議修改:這個函數目前約 120 行,同時做了價格計算、優惠券校驗和日誌記錄。是否考慮把優惠券校驗拆成單獨的函數?這樣也方便給它單獨寫測試。不阻斷這次合併,可以另開任務。
同款作品
用這條提示詞做出來的作品;原作者會因此獲得積分
還沒有同款,來做第一個。


0 條評論
還沒有評論,來搶沙發~