# 重構 (refactor)

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

提取函數、內聯函數等重構操作。

## 支援的動作

| 動作 | 說明 |
|------|------|
| `extract-function` | 提取程式碼為函數（TS/JS） |
| `extract-closure` | 提取程式碼為閉包（Swift） |
| `inline-function` | 內聯函數呼叫 |

## 用法

```bash
# 提取函數
agent-ide refactor extract-function --file src/file.ts --start-line 10 --end-line 20 --function-name newFn --dry-run

# 提取閉包（Swift）
agent-ide refactor extract-closure --file src/file.swift --start-line 10 --end-line 20 --function-name newClosure --dry-run

# 跨檔案提取（提取到新檔案並自動加入 import）
agent-ide refactor extract-function --file src/file.ts -s 10 -e 20 -n helper --target-file src/utils.ts --dry-run

# 內聯函數
agent-ide refactor inline-function --file src/file.ts --function-name helperFn --dry-run
```

## 參數

### extract-function / extract-closure

| 參數 | 說明 |
|------|------|
| `--file` | 來源檔案路徑 |
| `-s, --start-line` | 起始行號 |
| `-e, --end-line` | 結束行號 |
| `-n, --function-name` | 新函數名稱 |
| `-t, --target-file` | 目標檔案（跨檔案提取） |
| `--dry-run` | 預覽模式 |
| `--format` | 輸出格式 |

### inline-function

| 參數 | 說明 |
|------|------|
| `--file` | 檔案路徑 |
| `--function-name` | 要內聯的函數名稱 |
| `--dry-run` | 預覽模式 |
| `--format` | 輸出格式 |

## 輸出格式

### diff（預設）

```diff
--- a/src/services/order-service.ts
+++ b/src/services/order-service.ts
@@ -1,4 +1,4 @@
+function extractedFn(order: Order) {
+  // extracted code
+}
+
 export class OrderService {
   processOrder(order: Order) {
-    // original code here
+    extractedFn(order);
   }
 }

Summary: 1 file, 4 changes, (+2 -2)
```

### summary

```
Extracted function 'extractedFn'

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

Files:
  src/services/order-service.ts: code refactored (+2 -2)
```

### json

```json
{
  "command": "refactor",
  "success": true,
  "files": [
    {
      "filePath": "src/file.ts",
      "hunks": [
        {
          "header": "@@ -10,15 +10,20 @@",
          "lines": [
            { "type": "add", "lineNumber": 10, "content": "function newFn() {" },
            { "type": "add", "lineNumber": 11, "content": "  // extracted code" },
            { "type": "add", "lineNumber": 12, "content": "}" }
          ]
        }
      ]
    }
  ],
  "summary": { "totalFiles": 1, "totalChanges": 5 }
}
```

## 特性

- 自動分析變數依賴，生成正確的參數列表
- 跨檔案提取自動加入 import/export
- 內聯時自動處理參數替換