autofix

autofix 技能概覽

autofix 的用途

autofix 技能可以幫你安全地把 CodeRabbit review thread 的回饋，真正轉成目前 GitHub PR 上的程式碼變更。它是為了這種情境而設計：你希望 agent 先讀取 thread 層級的留言、驗證內容，再在明確授權下套用修正，而不是盲目照著 reviewer 的文字直接改。這也讓 autofix 特別適合需要 CodeRabbit for Code Review 工作流程的開發者，而不只是想找一個通用的「修正 review comments」提示詞。

適合誰使用

如果你的分支已經有開啟中的 PR、PR 裡有 CodeRabbit review thread，而且你想要一個可重複的流程把它們收尾，autofix 就很適合。它很適合維護者、貢獻者，以及在具備 GitHub CLI 存取權的 repo 裡工作的 agent。相對地，如果你只有一串扁平的評論、沒有 PR 上下文，或沒有權限檢視 repo 並推送變更，那它的幫助就有限。

為什麼它和一般提示詞不同

autofix 的核心價值在於紀律：它把 reviewer 提供的提示文字視為不可信輸入，會先檢查 repository 狀態，並預期一個有分支意識的 GitHub 工作流程。這能降低套用不安全或與上下文不符變更的機率。如果你要的是一個偏決策導向、而不是一次性提示詞的 autofix skill，這就是正確的形式。

如何使用 autofix 技能

安裝 autofix

使用 repository 的 skill manager 指令安裝：npx skills add coderabbitai/skills --skill autofix。在執行前，先確認 gh auth status 可正常運作，而且你目前所在的目錄就是有開啟中 PR 的 repo。只有當該分支已經有 CodeRabbit review feedback 可以處理時，autofix 的安裝才真正值得。

給 skill 正確的輸入

要把 autofix 用好，請提供分支上下文、PR 目標，以及任何會影響實作的本機限制。較弱的請求是「修一下 review comments」。更好的提示詞會像這樣：「在目前分支的 PR 上使用 autofix，檢查尚未解決的 CodeRabbit threads，遵守 AGENTS.md，只針對 auth 和 lint 失敗的評論套用已驗證的修正。」目標區域越明確，skill 就越不容易把不相關的程式碼也一起過度修正。

先讀這些檔案

先從 SKILL.md 開始，再看 github.md，最後看任何 repo 層級的 AGENTS.md。SKILL.md 會說明工作流程與安全規則；github.md 提供可重複使用的 GitHub 基礎動作；AGENTS.md 可能會覆寫 build、test 或 commit 行為。如果跳過這些檔案，autofix 還是能跑，但 patch 的品質和流程安全性通常都會下降。

重要的工作流程提示

請在一個已經有開啟中 PR、而且已被 CodeRabbit review 的分支上使用 autofix，同時確保 git status 夠乾淨，方便清楚歸屬變更。每一個建議修正都要先對照實際程式碼驗證，而不是只看 review thread 的文字。如果 thread 的要求很模糊，先用自己的話重述它真正的意圖，再去改程式碼；這是避免把 reviewer 的提示誤讀成指令的最簡單方式。

autofix 技能 FAQ

autofix 只適用於 CodeRabbit review threads 嗎？

是，這就是它的核心定位。autofix 是為 GitHub PR 上具備 thread 認知的 CodeRabbit feedback 而設計，不是用來做一般 issue 分流，也不是處理普通 pull request 摘要。如果你的評論來自其他 review 工具，你也許還是能借用它的工作流程概念，但這個 skill 並不是為那條路徑最佳化的。

使用 autofix 需要 GitHub CLI 嗎？

需要。autofix 技能假設 gh 和 git 都可用，而且 gh auth status 必須成功。沒有 GitHub CLI 存取權，就會失去分支到 PR 的對應查找、thread 擷取，以及讓這個 skill 保持可靠的 PR 協調能力。

autofix 對新手友善嗎？

如果你已經能在 Git repo 裡工作，並理解 PR，autofix 對新手算友善。這個 skill 可以幫你減少猜測，但它仍然期待你能判斷 reviewer comment 什麼時候是錯的、不完整的，或不能照字面直接執行。新手應該在需要有結構的協助時使用 autofix，而不是指望工具替你做所有判斷。

什麼時候不該使用 autofix？

如果沒有開啟中的 PR、沒有 CodeRabbit review，或沒有修改該分支的權限，就不要使用 autofix。當 review comment 其實是在要求產品決策、架構選擇，或超出 PR thread、需要人類核准的範圍變更時，也應該避免使用。在這些情況下，正常討論或更完整的實作計畫，會比 autofix 更合適。

如何改進 autofix 技能

提供更好的 PR 上下文

要讓 autofix 有好結果，最重要的是明確寫出分支目標、最可能相關的檔案，以及任何重要的 repo 規則。例如：「修正 src/auth/* 中尚未解決的 CodeRabbit 註記，維持目前 API 穩定，並依照 AGENTS.md 執行 repo 要求的測試」會比泛泛一句「套用 review」更有用得多。好的輸入會把修正範圍縮小，但不會把實作方式綁死。

注意常見失敗模式

最大的失敗模式，是把 review thread 的文字當成具權威性的程式碼。autofix 在把評論視為報告，並在編輯前先檢查 codebase 時會更安全。另一個失敗模式是過度廣泛的整理：針對某個 thread 的修正，可能意外碰到不相關的邏輯。請把需求範圍收斂，只要求你真的想處理的、尚未解決的 CodeRabbit 項目。

第一次執行後要迭代

第一次跑完 autofix 之後，請檢查 diff 的正確性，而不只是看留言是否被關閉。如果變更範圍太大，下一輪就明確說明哪些內容要保留、哪些內容要收斂。如果某個 thread 看起來仍未解決，請直接引用該 thread 的精確目標和相關檔案路徑，讓 skill 能分辨是確實漏掉了，還是刻意保留的選擇。