request-refactor-plan

關於 request-refactor-plan

request-refactor-plan 是來自 mattpocock-skills-zh-cn 集合（已廢棄路徑）的一項中文翻譯類規劃技能，它透過與使用者交流來制定詳細的重構計劃，該計劃會被拆分為多個小型提交，隨後以 GitHub issue 的形式儲存。它要解決的是大規模重構若一次性完成會存在風險的問題；該技能遵循馬丁·福勒的建議，強制要求採用逐步推進的方式，確保每一步都始終能讓程式正常執行。

其操作流程（部分步驟可跳過）如下：讓使用者描述問題及候選解決方案；探索程式碼倉庫以驗證使用者的陳述並瞭解當前狀態；提出其他可選方案；深入詢問使用者關於實現的細節；明確具體的工作範圍，包括哪些內容會更改、哪些不會更改；檢查受影響區域的測試覆蓋率，若覆蓋率較低則詢問使用者的測試計劃；將實現過程拆分為一系列小型提交，確保每次提交後程式碼庫仍能正常執行；最後使用提供的模板建立 GitHub issue，該模板包含問題描述、解決方案、提交記錄、決策文件、測試相關決策、不在範圍內的內容以及可選的補充說明等板塊。模板刻意避免使用具體的檔案路徑和程式碼片段，因為這些內容很快就會過時。

該技能適用於那些需要規劃重構或撰寫重構提案的開發者及技術主管，他們希望獲得一份嚴謹、以訪談為基礎、逐步推進且可長期儲存的規劃方案。其功能僅為程式碼倉庫探索和 issue 建立，不會執行任何破壞性或敏感操作。

常見問題

這項技能會生成什麼？

它會使用包含問題描述、解決方案、提交記錄、決策文件、測試相關決策、不在範圍內的內容以及可選補充說明等板塊的模板，將詳細的重構計劃以 GitHub issue 的形式儲存下來。

它是如何確保重構安全的？

它遵循馬丁·福勒的建議，將工作拆分為多個小型提交，確保每次提交後程式碼庫仍能正常執行，從而避免大規模重構帶來的風險。

該計劃會提及具體的檔案或程式碼嗎？

不會。模板刻意省略了具體的檔案路徑和程式碼片段，因為這些內容很快就會過時；它側重於決策、模組、介面及功能行為方面的描述。

它對測試有何處理？

它會檢查受影響區域的測試覆蓋率，如果覆蓋率不足，會詢問使用者的測試計劃，隨後在 issue 中記錄相關的測試決策。

需要什麼前提條件？

需要一個可供探索和訪談的程式碼倉庫，以及建立包含完整計劃的 GitHub issue 的能力。