gh-vivalalova-agent-ide-plugins-skills-agent-ide/references/rename.md

符號重命名 (rename)

執行方式：以下 agent-ide 指 node ${PLUGIN_ROOT}/bin/agent-ide.js （PLUGIN_ROOT = 此 skill 所在 repo 根目錄，往上三層）

安全地跨專案重命名符號。

用法

# 預覽變更
agent-ide rename --path . --from getUserData --to fetchUserProfile --dry-run

# 執行重命名
agent-ide rename --path . --from getUserData --to fetchUserProfile

參數

參數	說明
--path	專案路徑
--from	原始符號名稱
--to	新符號名稱
--dry-run	預覽模式，不實際執行
--format	輸出格式：json、summary、diff

輸出格式

diff（預設）

--- a/src/models/user-model.ts
+++ b/src/models/user-model.ts
@@ -6,7 +6,7 @@
 import { BaseModel } from './base-model';

-UserModel
+UserEntity
   constructor(user: User) {

--- a/src/services/user-service.ts
+++ b/src/services/user-service.ts
@@ -5,10 +5,10 @@
-UserModel
+UserEntity

Summary: 2 files, 8 changes, (+4 -4)

summary

Renamed 'UserModel' to 'UserEntity'

Files: 2
Changes: 8 (+4 -4)

Files:
  src/models/user-model.ts: symbol renamed (+1 -1)
  src/services/user-service.ts: symbol renamed (+3 -3)

json

{
  "command": "rename",
  "success": true,
  "files": [
    {
      "filePath": "src/services/user.ts",
      "hunks": [
        {
          "header": "@@ -10,7 +10,7 @@",
          "oldStart": 10,
          "oldCount": 7,
          "newStart": 10,
          "newCount": 7,
          "lines": [
            { "type": "context", "lineNumber": 10, "content": "export class UserService {" },
            { "type": "delete", "lineNumber": 11, "content": "  getUserData() {" },
            { "type": "add", "lineNumber": 11, "content": "  fetchUserProfile() {" }
          ]
        }
      ]
    }
  ],
  "summary": { "totalFiles": 3, "totalChanges": 5 }
}

欄位說明

欄位	說明
files	受影響的檔案列表
files[].filePath	檔案路徑
files[].hunks	變更區塊列表
hunks[].header	diff header
hunks[].lines	變更行（context/delete/add）
summary.totalFiles	總受影響檔案數
summary.totalChanges	總變更數