request-refactor-plan

request-refactor-plan 技能總覽

request-refactor-plan 的用途

request-refactor-plan 技能可以把模糊的重構需求，整理成一份結構化計畫，拆成一個個小型 commit，最後再包裝成 GitHub issue。它是為 request-refactor-plan for Refactoring 這類情境而設計，適合想安全改善程式碼，而不是從頭重新設計的時候使用。

誰適合使用

如果你是工程師、技術主管，或正在準備重構 RFC、實作計畫，或需要清楚範圍的 issue 的 agent，這個 request-refactor-plan skill 都很適合。當 codebase 是真實的、變更不簡單，而且你希望在動手改之前少一點意外時，它特別有價值。

它和其他方法有什麼不同

這個技能不只是產出一段通用提示詞而已。它會要求先做使用者訪談、repo 驗證、界定範圍、檢查測試覆蓋率，並拆成逐個 commit 的工作分解。這讓輸出更適合做增量式重構規劃，因為可回復性與可審查性都很重要。

如何使用 request-refactor-plan 技能

安裝並啟用它

可以透過你的 skills manager 使用 request-refactor-plan install 流程，或在工具需要直接來源時，從 repository path 安裝。repo 位置是 mattpocock/skills 底下的 skills/deprecated/request-refactor-plan，所以在正式工作前，先確認你的本機 loader 仍然能解析 deprecated skills，再決定是否依賴它。

提供一份適合重構的簡報

這個技能在你的起始輸入包含以下內容時最有效：你想解決的問題、目前行為、涉及的程式碼區塊、限制條件，以及你已經考慮過的想法。好的提示詞會像這樣：“Refactor the billing retry flow to reduce coupling, keep API responses unchanged, preserve existing tests, and avoid database schema changes.”

依照它預期的工作流程來走

request-refactor-plan usage 的模式是：先詳細描述問題、再驗證 repo 現況、討論替代方案、定義精確範圍、檢查測試，最後把工作拆成小型 commit。如果少了這些輸入，計畫通常會變得太廣，或太保守而派不上用場。

先讀這些檔案

先從 SKILL.md 開始，再視環境檢查 README.md、AGENTS.md、metadata.json，以及任何存在的 rules/、resources/、references/ 或 scripts/ 資料夾。在這個 repository 裡，主要的決策價值集中在 SKILL.md，所以可交叉比對的支援材料不多。

request-refactor-plan 技能 FAQ

這適合一般功能開發嗎？

不適合。request-refactor-plan skill 的目標是重構與範圍控制，不是功能探索。如果你需要的是功能規格、架構提案或 roadmap，可能會有其他 planning skill 或單純的 prompt 更適合。

需要很強的技術細節才能用嗎？

不需要完美的設計，但你要有足夠背景，才能把問題問清楚。如果你的簡報只有「把這個整理一下」，輸出多半會很泛；如果你能指出檔案、行為、風險與限制，計畫就會更可執行。

什麼情況下不該用它？

當變更很小、很明顯，或已經完整定義範圍時，就不需要用它。當你無法檢視 repo、無法確認測試覆蓋率，或不想承擔正式 issue 與逐步計畫的額外成本時，它也不是理想選擇。

它和一般 prompt 比起來差在哪？

一般 prompt 可能只會給你一份重構檢查清單，但 request-refactor-plan 多了流程紀律：驗證、替代方案檢視、範圍鎖定、測試提問，以及小型 commit 拆分。這能降低過度重構，或漏掉隱性耦合的風險。

如何改進 request-refactor-plan 技能

第一輪就提供更精準的輸入

想最快改善結果，關鍵是清楚說明目前的痛點、希望達成的狀態，以及明確的非目標。比如：“Reduce duplicated validation logic in src/payments/*, keep public APIs stable, do not rename exported functions, and preserve current error messages.” 這能讓 request-refactor-plan 指南有足夠結構，避免瞎猜。

補上測試與風險背景

這個技能會問覆蓋率，是有原因的：測試強弱會直接改變計畫。告訴它目前有哪些測試保護這個區域、哪些失敗是不能接受的，以及你是否能在重構前或後加測試。如果你省略這些資訊，計畫可能會太激進，或太保守。

注意常見失敗模式

最常見的失敗是範圍縮得不夠、範圍拉得太大，或最終狀態不夠具體。如果第一版輸出看起來太廣，就把目標檔案縮小、明確指出哪些行為必須維持不變，並要求更小的 commit 序列。如果它看起來太保守，就補上這次重構的業務理由，以及足以支持變更的驗收標準。

用 issue 草稿持續迭代

把產出的 GitHub issue 當成工作草稿，而不是最後定稿。要改善 request-refactor-plan for Refactoring 的結果，可以重寫問題陳述、移除推測性步驟，並收緊 commit 清單，直到每一步都能被獨立審查。