refactor-plan

重構計畫

在進行任何程式碼變更前，先建立詳細計畫。

操作說明

1. 準備計畫期間，請勿編輯檔案。
2. 搜尋程式碼庫以了解當前狀態。閱讀足夠的實作、測試、設定和文件，使計畫能針對該儲存庫具體化。
3. 識別受影響的檔案、所有權邊界、相依性以及可能的隱藏耦合。
4. 以安全順序規劃變更。優先處理合約和型別，再處理實作，接著是呼叫端，然後是測試，最後是清理。
5. 在各階段之間包含驗證步驟，以及最終的驗證指令。
6. 針對風險最高的階段，包含復原或回復步驟。
7. 使用以下格式輸出完整計畫。
8. 計畫完成後停止，並在實作前要求確認。如果使用者已要求你實作，仍應先產出計畫並等待確認，除非他們明確表示在計畫後無需審查即可繼續。

如果請求過於模糊而無法安全規劃，請提出簡潔的釐清問題，而非編輯檔案。

輸出格式

## 重構計畫：[標題]

### 當前狀態
[簡述目前運作方式]

### 目標狀態
[簡述重構後運作方式]

### 受影響檔案
| 檔案 | 變更類型 | 相依性 |
|------|----------|--------|
| 路徑 | 修改/新增/刪除 | 阻擋 X，被 Y 阻擋 |

### 執行計畫

#### 階段 1：型別與介面
- [ ] 步驟 1.1：在 `file.ts` 中[動作]
- [ ] 驗證：[如何確認運作正常]

#### 階段 2：實作
- [ ] 步驟 2.1：在 `file.ts` 中[動作]
- [ ] 驗證：[如何確認]

#### 階段 3：測試
- [ ] 步驟 3.1：更新 `file.test.ts` 中的測試
- [ ] 驗證：執行 `npm test`

#### 階段 4：清理
- [ ] 移除已棄用的程式碼
- [ ] 更新文件

### 復原計畫
如果發生問題：
1. [復原步驟]
2. [復原步驟]

### 風險
- [潛在問題與因應措施]

計畫完成後，詢問：「是否繼續進行階段 1？」