orch-refine-code 是做什麼的?
Actor · action · target:orch · refine · code。是 orch-pipeline 中共用引擎的精簡包裝。
使用時機
- 相同行為,更好的結構:提取模組、移除重複、清除死碼、減少巢狀、重新命名以提升清晰度。
- 與同系列技能區分:如果行為有任何變更,則不應使用此技能(應改用
orch-change-feature/orch-fix-defect)。
操作設定
- 預設規模下限: 標準 — 重構會觸及多個檔案。
- 階段遮罩: 0 → 2(規劃重構)→ 4(保持通過)→ 5 → 6。不會撰寫新的行為測試 — 現有測試套件是安全網。
- 第一步(階段 4): 確認相關測試存在且在修改程式碼前為通過狀態;若測試覆蓋率不足,先新增特徵測試(characterization tests)。然後以小步驟進行重構,每步後重新執行測試。
運作方式
- 使用上述設定執行
orch-pipeline引擎。 - 對於死碼/重複清理,委派給
refactor-cleaneragent(它會執行 knip / depcheck / ts-prune 並安全移除)。 - 在閘門 1(重構計劃)和閘門 2(提交前)暫停。
- 以
refactor:提交 — 變更必須是行為中立的。
範例
orch-refine-code: 從 poller.py 中提取 NWS HTTP 客戶端
→ 確認測試通過 → 規劃提取 [閘門 1:批准]
→ 以小步驟移動,測試始終通過 → 程式碼審查
→ 提交 refactor: [閘門 2:確認]