vivalalova avatar

agent-ide

TS/JS 程式碼智能重構工具。重命名、移動檔案、清理 dead code、修改函式簽章時自動更新所有引用。

提供方 vivalalova|开源

Agent IDE

TS/JS 程式碼智能重構工具。

功能列表

功能用途
cycles循環依賴檢測
impact變更影響分析
search符號搜尋
find-references符號引用查找
call-hierarchy呼叫層次追蹤
rename重命名符號 + 自動更新引用
move移動檔案/成員 + 自動更新 import
change-signature修改函式參數 + 更新呼叫點
deadcode檢測/清理未使用程式碼

全域選項

  • --no-cache：停用索引快取
  • --cache-dir <path>：覆寫索引快取目錄
  • --verbose：顯示詳細處理資訊

最佳實踐

重構標準流程

1. deadcode     → 清理未使用程式碼（清場）
2. search       → 找入口與主要符號（偵察）
3. cycles       → 檢測循環依賴（診斷）
4. move         → 重組檔案/成員（重構）
5. rename       → 修正命名風格（收尾）

場景選用指南

場景功能說明
接手新專案deadcode → search先清垃圾，再找入口
重構前診斷cycles → impact找問題點，評估影響範圍
找符號入口search <symbol>模糊搜尋符號位置
檔案重組move src/a.ts src/b/自動更新所有 import
抽取函式move src/a.ts:25 src/b.ts移動成員到新位置
統一命名rename --from userId --to uid全專案一致性
修改 APIchange-signature參數順序/名稱變更
追蹤呼叫call-hierarchy → find-references理解函式使用情況

安全操作原則

  1. 先 --dry-run 再執行：變更類功能務必預覽
  2. 清理優先於重構：deadcode 減少不必要的移動/重命名
  3. 小步快跑：一次只做一種類型的變更，便於回滾
  4. 重構後驗證：cycles 確保沒引入循環依賴
下载 Skill