orch-refine-code 是做什麼的?
角色 · 動作 · 目標:orch · refine · code。這是對 orch-pipeline 中共享引擎的精簡封裝。
使用時機
- 相同行為,更好的結構:提取模組、消除重複、移除死代碼、減少巢狀、為清晰而重新命名。
- 與同類技能區分:如果行為有變,則不應使用此技能(應使用
orch-change-feature/orch-fix-defect)。
操作設定
- 預設規模底線: 標準 — 重構會觸及多個檔案。
- 階段遮罩: 0 → 2(規劃重構)→ 4(保持綠燈)→ 5 → 6。不撰寫新的行為測試 — 既有的測試套件即為安全網。
- 第一步(第 4 階段): 在觸碰程式碼之前,確認相關測試存在且為綠燈;若覆蓋率不足,先新增特徵描寫測試。然後以小幅度步驟進行重構,每步後重新執行測試。
運作方式
- 以上述設定執行
orch-pipeline引擎。 - 處理死代碼/重複代碼掃除時,委派給
refactor-cleaner代理(它會執行 knip / depcheck / ts-prune 並安全移除)。 - 在閘門 1(重構規劃)和閘門 2(提交前)停止。
- 提交訊息為
refactor:— diff 必須是行為中性的。
範例
orch-refine-code: 從 poller.py 中提取 NWS HTTP 客戶端
→ 確認測試為綠燈 → 規劃提取 [閘門 1:批准]
→ 小幅步驟移動,過程中測試保持綠燈 → 代碼審查
→ 提交 refactor: [閘門 2:確認]