@bovinphang/frontend-craft 2.8.0 → 3.0.0

package/docs/zh-TW/README.md

@@ -22,6 +22,9 @@
 
 </div>
 
+
+[執行環境相容性與升級說明](../runtimes/compatibility.md)
+
 ---
 
 `frontend-craft` 是一個**通用前端插件**，為以下 **15 款 AI 程式設計助手**注入統一的前端工程規範：
@@ -32,7 +35,7 @@
 
 各執行時的路徑與注意事項詳見 [`docs/runtimes/`](../runtimes/)。
 
-它將 **13 個專業 agent**、**45 個自動啟用 skill**、**8 個斜線指令**、**5 個事件驅動 hook**、面向 6 個設計工具端點的 **MCP 整合**以及一整套**規則庫**打包為一個可安裝單元。執行一條指令，團隊裡的每一次 AI 會話都將以相同的方式編寫 React、Vue、Next.js 或 Nuxt——型別安全、可存取、安全、一致。
+它將 **14 個專業 agent**、**61 個自動啟用 skill**、**11 個斜線指令**、**5 個事件驅動 hook**、面向 6 個設計工具端點的 **MCP 整合**以及一整套**規則庫**打包為一個可安裝單元。執行一條指令，團隊裡的每一次 AI 會話都將以相同的方式編寫 React、Vue、Next.js 或 Nuxt——型別安全、可存取、安全、一致。
 
 ---
 
@@ -40,10 +43,10 @@
 
 | 痛點                                            | frontend-craft 的解法                                                                   |
 | ----------------------------------------------- | --------------------------------------------------------------------------------------- |
-| AI 助手寫出的前端程式碼風格不一、缺型別、不安全 | **45 個 skill** 將團隊規範編碼為可自動啟用的工作流                                      |
+| AI 助手寫出的前端程式碼風格不一、缺型別、不安全 | **61 個 skill** 將團隊規範編碼為可自動啟用的工作流                                      |
 | 每款 AI 工具都有自己的插件格式                  | **一條 CLI 指令** 把相同的規則、agent 和 hook 安裝到 15 個執行時                        |
 | 設計稿到程式碼的交接總有資訊損失                | **MCP 整合** 從 Figma、Figma Desktop、Sketch、MasterGo、Pixso、墨刀引入更完整設計上下文 |
-| 程式碼審查隨意、淺層                            | **13 個 agent** 輸出分級報告：程式碼、安全、無障礙、效能、TS、UI 還原度                 |
+| 程式碼審查隨意、淺層                            | **14 個 agent** 輸出分級報告：程式碼、安全、無障礙、效能、TS、UI 還原度                 |
 | 沒人記得跑 lint 和測試                          | **事件驅動 hook** 在儲存和會話結束時自動校驗                                            |
 | 新專案每次都從零開始                            | **`/fec-init`** 幾秒內腳手架化 CLAUDE.md、規則和 settings                               |
 
@@ -76,7 +79,7 @@ fec setup claude --global
 fec setup all --global
 
 # 6. 預覽 / 查詢
-fec install --all --dry-run --global
+fec runtime install --all --dry-run --global
 fec list
 ```
 
@@ -89,17 +92,17 @@ fec list
 npx @bovinphang/frontend-craft@latest
 
 # 2. 接入目前專案
-npx @bovinphang/frontend-craft@latest install --local codex
-npx @bovinphang/frontend-craft@latest install --local claude
-npx @bovinphang/frontend-craft@latest install --all --local
+npx @bovinphang/frontend-craft@latest runtime install --local codex
+npx @bovinphang/frontend-craft@latest runtime install --local claude
+npx @bovinphang/frontend-craft@latest runtime install --all --local
 
 # 3. 全域接入，適用於所有專案
-npx @bovinphang/frontend-craft@latest install --global codex
-npx @bovinphang/frontend-craft@latest install --global claude
-npx @bovinphang/frontend-craft@latest install --all --global
+npx @bovinphang/frontend-craft@latest runtime install --global codex
+npx @bovinphang/frontend-craft@latest runtime install --global claude
+npx @bovinphang/frontend-craft@latest runtime install --all --global
 
 # 4. 預覽 / 查詢
-npx @bovinphang/frontend-craft@latest install --all --dry-run --global
+npx @bovinphang/frontend-craft@latest runtime install --all --dry-run --global
 npx @bovinphang/frontend-craft@latest list
 ```
 
@@ -109,7 +112,7 @@ npx @bovinphang/frontend-craft@latest list
 
 對 Claude Code 用戶，**Claude Code Marketplace** 是推薦的單一來源安裝方式。只有在需要跨執行時安裝、腳本化/離線複製檔案，或非 Marketplace 環境時，才建議對 Claude 使用 CLI。
 
-如果已經透過 Marketplace 安裝，CLI 不會再安裝或更新第二份 Claude 副本，即使傳入 `--force` 也不會覆蓋；請透過 Claude Code Marketplace 更新。如果已存在另一個作用域的 CLI 管理安裝，互動式終端會詢問是保持已安裝來源並更新，還是解除安裝後切換至當前來源；非互動式終端會停止並列印明確的 `update`、`uninstall`、`install` 命令。
+如果已經透過 Marketplace 安裝，CLI 不會再安裝或更新第二份 Claude 副本，即使傳入 `--force` 也不會覆蓋；請透過 Claude Code Marketplace 更新。如果已存在另一個作用域的 CLI 管理安裝，互動式終端會詢問是保持已安裝來源並更新，還是解除安裝後切換至當前來源；非互動式終端會停止並列印明確的 `runtime update`、`runtime uninstall`、`runtime install` 命令。
 
 完整步驟見 [docs/runtimes/claude.zh-CN.md](../runtimes/claude.zh-CN.md) · [English](../runtimes/claude.md)。
 
@@ -163,14 +166,31 @@ npx @bovinphang/frontend-craft@latest list
 | 指令                  | 用途                                                        | 報告                                             |
 | --------------------- | ----------------------------------------------------------- | ------------------------------------------------ |
 | `/fec-init`           | 初始化專案範本（CLAUDE.md、規則、settings）                 | —                                                |
-| `/fec-review`         | 對指定或最近變更的檔案執行結構化審查                        | `code-review-*.md`                               |
+| `/fec-review`         | 預設審查全專案；支援指定檔案、目錄或明確變更範圍 | `code-review-*.md`                               |
 | `/fec-scaffold`       | 依規範建立 page / feature / component 樣板                  | —                                                |
 | `/fec-plan`           | 統一規劃入口：實現架構或測試策略                            | `architecture-proposal-*.md` 或 `test-plan-*.md` |
 | `/fec-tdd`            | 紅 → 綠 → 重構的前端 TDD 循環                               | —                                                |
 | `/fec-debug`          | 前端問題診斷與修復：建置失敗、執行時錯誤、UI 異常、介面問題 | `debug-*.md`                                     |
 | `/fec-refactor-clean` | 分類並安全清理死程式碼、未使用匯出、樣式和依賴              | `refactor-clean-*.md`                            |
+| `/fec-smell` | Diagnose code smells without editing | `refactoring/smell-*.md` |
+| `/fec-refactor-plan` | Plan behavior-preserving refactoring | `refactoring/plan-*.md` |
+| `/fec-refactor` | Execute validated behavior-preserving refactoring | `refactoring/refactoring-*.md` |
 | `/fec-doc-sync`       | 同步 README、docs、環境變數、腳本、API/路由說明和部署文件   | —                                                |
 
+### 審查範圍
+
+`/fec-review`、程式碼 / TypeScript / 安全審查 agent 及其 skill 採用三種模式：
+
+- **變更審查**：明確要求最近變更、本次修改、暫存區、PR 或提交，或目前任務已明確這些變更範圍。沒有變更時說明情況，不自動審查最近提交。
+- **指定範圍審查**：指定檔案或目錄，審查其中現有程式碼，包括未變更程式碼，不要求 Git 差異。
+- **全專案審查（預設）**：未指定範圍或變更脈絡，或明確要求審查整個專案時，先建立專案自有前端程式碼、相關測試、設定與相依宣告清單，再按模組審查。
+
+指定檔案或目錄預設審查全部程式碼；明確要求本次變更才僅審查差異。即使有變更，單獨呼叫 `/fec-review` 仍預設全專案。開始時說明模式與範圍，修改後自動委託須明確傳入本次變更範圍。
+
+範例：`/fec-review`、`/fec-review 審查最近變更`、`/fec-review 審查 src/components/Button.tsx`、`/fec-review 審查 src/features/`、`/fec-review 審查整個專案`。這些是自然語言指令，不是 CLI 參數；明確指定的範圍優先於預設模式。
+
+預設排除相依目錄、建置產物、快取、生成檔案與第三方程式碼。報告記錄模式、目標範圍、已審查及未涵蓋檔案或模組、排除項目、完成狀態與驗證結果；涵蓋不足時標記部分完成。讀取呼叫端或執行全專案 lint/型別檢查不等於完成人工審查。變更審查保留合併建議，指定範圍與全專案審查評估已審查範圍的風險。前端審查不取代後端專項審查；未要求修復時不修改業務程式碼。
+
 ### 技能（Skills，自動啟用）
 
 技能是根據檔案模式、框架或任務上下文**自動啟用**的工作流定義，編碼了審查維度、輸出約定和報告格式。
@@ -187,7 +207,7 @@ npx @bovinphang/frontend-craft@latest list
 | `fec-nuxt-project-standard`       | Nuxt 3 SSR/SSG、組合式 API、資料獲取、中介軟體        |
 | `fec-vite-project-standard`       | Vite 設定、環境變數安全、HMR、開發代理、建置最佳化    |
 | `fec-monorepo-project-standard`   | pnpm workspace、Turborepo、Nx 結構與任務編排          |
-| `fec-typescript-project-standard` | TypeScript 設定、公開型別、宣告檔、DTO 和泛型         |
+| `cc-typescript-project-standard` | TypeScript 設定、公開型別、宣告檔、DTO 和泛型         |
 
 **實作能力** — 建構特定前端能力時啟用：
 
@@ -227,13 +247,29 @@ npx @bovinphang/frontend-craft@latest list
 | `fec-performance-optimization` | Core Web Vitals、包體、渲染、記憶體、網路與效能預算審查 |
 | `fec-refactor-clean`           | 安全清理死程式碼、未使用匯出、樣式、路由和依賴          |
 
+**Refactoring**
+
+| Skill | Scope |
+| --- | --- |
+| `fec-refactoring` | Behavior-preserving refactoring capability |
+| `fec-code-smells` | Behavior-preserving refactoring capability |
+| `fec-refactoring-catalog` | Behavior-preserving refactoring capability |
+| `fec-refactoring-functions` | Behavior-preserving refactoring capability |
+| `fec-refactoring-encapsulation` | Behavior-preserving refactoring capability |
+| `fec-refactoring-move-features` | Behavior-preserving refactoring capability |
+| `fec-refactoring-data` | Behavior-preserving refactoring capability |
+| `fec-refactoring-control` | Behavior-preserving refactoring capability |
+| `fec-refactoring-api` | Behavior-preserving refactoring capability |
+| `fec-refactoring-inheritance` | Behavior-preserving refactoring capability |
+| `fec-refactoring-validation` | Behavior-preserving refactoring capability |
+
 **設計 UI** — 設計實作、設計系統或視覺打磨時啟用：
 
 | 技能                          | 範圍                                                                                             |
 | ----------------------------- | ------------------------------------------------------------------------------------------------ |
 | `fec-ui-design`               | 產品語境 UI 方向、反模板設計撥盤、媒體策略、狀態、視覺 QA                                        |
-| `fec-image-generation`        | 系統藍圖、流程工作流、互動式即時圖、HTML/SVG/PNG 匯出、圖片生成/編輯、視覺資產和 PNG 自檢         |
-| `fec-drawio-studio`           | 可編輯 draw.io / diagrams.net 技術圖、XML/Mermaid/CSV URL 交付、形狀檢索、自動布局和程式碼結構圖 |
+| `fec-image-generation`        | UI、產品和品牌視覺生成與編輯，重用共用 PNG 檢查 |
+| `cc-drawio-studio`           | 可編輯 draw.io / diagrams.net 技術圖、XML/Mermaid/CSV URL 交付、形狀檢索、自動布局和程式碼結構圖 |
 | `fec-web-video-presentation`  | 將文章、口播稿、課程和 demo 轉成可錄屏的 16:9 步進網頁演示                                       |
 | `fec-tailwind-design-system`  | Tailwind token、主題擴展、元件變體、class 治理和暗色模式                                         |
 | `fec-responsive-layout`       | 移動優先布局、容器查詢、資料密集型響應式界面                                                     |
@@ -241,6 +277,10 @@ npx @bovinphang/frontend-craft@latest list
 | `fec-implement-from-design`   | 基於設計工具、截圖或分區級視覺參考實現 UI                                                        |
 | `fec-storybook-component-doc` | Storybook 元件文件、設計系統呈現、隔離狀態預覽                                                   |
 
+技術圖品質：標準時序圖、流程圖優先本機 Mermaid，可編輯架構圖優先 draw.io；工具缺少時使用 JSON/HTML。以符合 PNG 比例的實測 manifest 執行 QA，並檢視最終圖片。預設最多修復兩輪，未解決問題必須明確回報。
+
+[審查範圍與技術圖交付指南](../zh-CN/review-and-diagram-workflows.md).
+
 **遺留遷移** — 現代化遷移時啟用：
 
 | 技能                             | 範圍                                           |
@@ -260,7 +300,7 @@ npx @bovinphang/frontend-craft@latest list
 | ---------------------------------- | --------------------------------------------------------------------- |
 | `fec-backend-requirements-handoff` | 前端向後端交接 UI 資料需求、使用者動作、狀態、業務規則與待確認問題    |
 | `fec-doc-sync`                     | 讓前端文件與程式碼、設定、腳本、路由、API、環境變數和部署事實保持同步 |
-| `fec-source-driven-development`    | 以專案事實和官方來源驗證版本敏感的前端決策                            |
+| `cc-source-driven-development`    | 以專案事實和官方來源驗證版本敏感的前端決策                            |
 
 ### 代理（Agents）
 
@@ -276,6 +316,7 @@ npx @bovinphang/frontend-craft@latest list
 | `fec-test-planner`          | 風險-層級映射：靜態、單元、元件、E2E、視覺、無障礙、安全  | `test-plan-*.md`             |
 | `fec-debugger`              | 複雜前端診斷：建置、執行時、UI 和介面問題                 | `debug-*.md`                 |
 | `fec-refactor-cleaner`      | 分類並安全清理未使用程式碼、匯出、樣式、路由和依賴        | `refactor-clean-*.md`        |
+| `fec-refactoring-expert` | Behavior-preserving refactoring orchestration | `refactoring/refactoring-*.md` |
 | `fec-e2e-runner`            | E2E 撰寫與執行（Playwright/Cypress）、flaky 隔離、Trace   | `e2e-summary-*.md`           |
 | `fec-doc-updater`           | 同步 README、runtime 文件、結構、能力表和 metadata        | —                            |
 | `fec-ui-checker`            | 視覺問題排查與設計還原度評估                              | `ui-fidelity-review-*.md`    |
@@ -419,33 +460,55 @@ $env:MODAO_TOKEN = "your-modao-token"
 
 ## 更新與移除
 
-`fec` 是 `frontend-craft` 的短命令。如果沒有全域安裝 `fec`，可以把同樣參數接在 `npx @bovinphang/frontend-craft@latest` 後使用，例如 `npx @bovinphang/frontend-craft@latest update`。
+### CLI 自身管理（3.0）
 
-### 更新
+`fec update`（別名 `upgrade`）透過原 npm/pnpm 將全域 CLI 升級至原 registry 的 `latest`，再啟動新版 CLI 更新目前專案及使用者全域的託管資源；已是最新版也會更新。不掃描其他專案，不管理 Marketplace。CLI 升級失敗即停止；資源部分失敗會分階段回報，不回復 CLI，可執行 `fec runtime update` 重試。
+
+`fec uninstall`（別名 `remove`）預設僅解除安裝 CLI；`--purge` 先清理託管資源並保留使用者修改，清理失敗則保留 CLI。互動終端需要確認，非互動終端必須加 `--yes`。僅支援已驗證歸屬的 npm/pnpm registry 全域安裝；原始碼連結、專案依賴、未知來源及含其他套件的 pnpm 共用安裝群組均在修改前拒絕，請透過原套件管理器手動管理。`--dry-run` 僅唯讀預覽，不安裝、刪除或啟動後續更新。
+
+```bash
+fec update
+fec uninstall --dry-run
+fec uninstall --purge --yes
+```
+
+暫時 npx 執行不建立全域 CLI，也不支援自身解除安裝。npx 頂層 `update` 僅在目前版本等於 registry `latest` 時更新資源，否則使用 `npx @bovinphang/frontend-craft@latest runtime update`。
+
+| 2.x 資源命令 | 3.0 替代命令 |
+| --- | --- |
+| `fec update [runtime] [options]` | `fec runtime update [runtime] [options]` |
+| `fec uninstall [runtime] [options]` | `fec runtime uninstall [runtime] [options]` |
+| `fec install [runtime] [options]` | `fec runtime install [runtime] [options]` |
+
+頂層 update/uninstall 在修改前拒絕舊 runtime 參數及 `--global` 等資源選項。`setup` 保留；頂層 `install` 為已棄用的相容入口。資源選項及 `runtime upgrade/remove` 別名保留。`runtime update` 僅使用目前 CLI 套件內容，不連網取得新套件。
+
+`fec` 是 `frontend-craft` 的短命令。未全域安裝 CLI 時，資源操作使用 `npx @bovinphang/frontend-craft@latest runtime update`（或 `runtime install/uninstall`）。
+
+### 資源更新
 
 ```bash
-fec update                         # 更新自動發現到的所有 CLI 管理安裝
-fec update <runtime> --local        # 更新一個本地 CLI 管理安裝
-fec update <runtime> --global       # 更新一個全域 CLI 管理安裝
-fec upgrade <runtime> --global      # `upgrade` 是 `update` 的別名
+fec runtime update                              # 更新自動發現到的所有 CLI 管理安裝
+fec runtime update <runtime> --local            # 更新一個本地 CLI 管理安裝
+fec runtime update <runtime> --global           # 更新一個全域 CLI 管理安裝
+fec runtime upgrade <runtime> --global          # `upgrade` 是 `update` 的別名
 ```
 
-### 移除
+### 資源移除
 
 ```bash
-fec uninstall                       # 移除自動發現到的所有 CLI 管理安裝
-fec remove                          # `remove` 是 `uninstall` 的別名
-fec uninstall <runtime>             # 移除指定 runtime 安裝
-fec remove <runtime>                # 使用別名移除指定 runtime
-fec uninstall --global              # 只移除發現到的全域安裝
-fec remove --local                  # 只移除發現到的本地安裝
-fec uninstall <runtime> --dry-run   # 預覽將移除的檔案
-fec uninstall <runtime> --force     # 連同已修改的託管檔案一起移除
+fec runtime uninstall                           # 移除自動發現到的所有 CLI 管理安裝
+fec runtime remove                              # `remove` 是 `uninstall` 的別名
+fec runtime uninstall <runtime>                 # 移除指定 runtime 安裝
+fec runtime remove <runtime>                    # 使用別名移除指定 runtime
+fec runtime uninstall --global                  # 只移除發現到的全域安裝
+fec runtime remove --local                      # 只移除發現到的本地安裝
+fec runtime uninstall <runtime> --dry-run       # 預覽將移除的檔案
+fec runtime uninstall <runtime> --force         # 連同已修改的託管檔案一起移除
 ```
 
-CLI 會在 runtime 目錄寫入 `frontend-craft.manifest.json`。不傳 runtime 時，`update` 會自動發現這些 manifest，並**跳過你本地修改過的檔案**——自訂內容在更新後依然保留。
+CLI 會在 runtime 目錄寫入 `frontend-craft.manifest.json`。不傳 runtime 時，`runtime update` 會自動發現這些 manifest，並**跳過你本地修改過的檔案**——自訂內容在更新後依然保留。
 
-`uninstall`/`remove` 只刪除 manifest 記錄的檔案，預設跳過已修改檔案；只有確認要移除修改過的託管檔案時才加 `--force`。`--force` 不會覆蓋 Claude Code Marketplace 安裝。
+`runtime uninstall`/`runtime remove` 只刪除 manifest 記錄的檔案，預設跳過已修改檔案；只有確認要移除修改過的託管檔案時才加 `--force`。`--force` 不會覆蓋 Claude Code Marketplace 安裝。
 
 **Claude Code Marketplace** 或 **submodule** 安裝的更新方式見 [docs/runtimes/claude.zh-CN.md](../runtimes/claude.zh-CN.md) · [English](../runtimes/claude.md)。`/fec-init` 只初始化專案設定，不是第二次安裝插件本體。
 
@@ -491,3 +554,35 @@ npx skills check                           # 預覽可用更新
 **如果 frontend-craft 幫助了你的團隊，[請給它一個 Star](https://github.com/bovinphang/frontend-craft)。**
 
 </div>
+
+## 3.0 共用能力
+
+3.0.0仍未發布，包含53個前端專屬入口與21個共用入口，共74個Skill。公共來源精確固定為`@bovinphang/craft-common@2.0.0`；2.0.0為待發布的正式版本號，backend1.0.0也仍未發布。公共包先行發布並核驗，產品版本不變，不自動發布。
+
+語言、角色與框架分開選擇；C/C++有獨立入口，Tauri/Electron為共用桌面專項，不以產品前後端名稱限制語言。
+
+- `cc-c-project-standard`
+- `cc-cpp-project-standard`
+- `cc-debug-methodology`
+- `cc-doc-sync-core`
+- `cc-drawio-studio`
+- `cc-electron-project-standard`
+- `cc-go-concurrency`
+- `cc-go-project-standard`
+- `cc-java-project-standard`
+- `cc-java-runtime`
+- `cc-native-memory-safety`
+- `cc-python-async`
+- `cc-python-project-standard`
+- `cc-refactoring-core`
+- `cc-rust-async`
+- `cc-rust-project-standard`
+- `cc-source-driven-development`
+- `cc-tauri-project-standard`
+- `cc-tdd-methodology`
+- `cc-technical-diagrams`
+- `cc-typescript-project-standard`
+
+執行`fec runtime check-migration codex --local --json`，先以舊CLI退出舊公共引用並處理保留編輯，再安裝匹配產品；不強制覆蓋另一消費者或未知檔案。CLI與原生渠道互斥，雙原生產品去重仍不在保證範圍。
+
+[遷移指南](../zh-CN/common-migration.md) · [變更日誌](../../CHANGELOG.zh-CN.md) · [專案結構](../zh-CN/project-structure.md)

package/localized/zh-CN/agents/fec-code-reviewer.md

@@ -19,14 +19,30 @@ skills:
 
 你是一名资深**前端**代码评审者，范围覆盖浏览器端 UI、组件、状态、样式、类型、性能与客户端安全；不替代后端专项评审，但若变更涉及 BFF 或同仓 API 路由，可对明显问题顺带标注。
 
+## 评审模式与覆盖范围
+
+用户明确指定的范围优先于默认行为。遵循 `fec-code-review` 的三种模式：
+
+- **改动审核**：仅在明确要求或当前任务已明确最近改动、本次修改、暂存区、PR 或提交上下文时，审核这些改动及必要上下文。本地模式在请求范围内检查暂存、未暂存差异及相关未跟踪项目文件；仅要求暂存区时只审核暂存改动。无改动时说明没有可审核的改动，不自动切换到最近提交或扩大范围。
+- **指定范围审核**：用户指定文件或目录时，建立范围内文件清单，审核其中现有代码，包括未改动代码；不要求 Git 差异。
+- **全项目审核（默认）**：未指定范围或改动上下文，或明确要求审核整个项目时，建立项目自有前端代码、相关测试、配置和依赖声明的清单，再按模块分批审核，包括未改动代码；不要求 Git 差异。
+
+先选择范围，再收集差异。仅指定文件或目录表示全量审核该范围；路径与明确改动请求同时出现时，仅增量审核该路径的改动。未限定的调用即使存在 Git 改动也默认全项目审核。开始审核时说明选定模式和目标范围。修改后自动委托审核时，显式传入本次改动范围，避免无范围调用触发全项目审核。
+
+默认排除依赖目录、构建产物、缓存、生成文件和第三方代码，并记录排除项。保持前端职责边界，不宣称完成后端专项审核。目标不存在或范围内无相关文件时，明确说明，不替换为其他范围。
+
+跨批次合并同根因发现。报告记录**审核模式、目标范围、已审核文件或模块、排除项、未覆盖文件或模块、完成状态及验证命令和结果**。受上下文或执行预算限制时，标记部分完成并列出剩余模块，不宣称已完成全项目覆盖。为理解上下文而读取调用方或执行全项目 lint/类型检查，不计为完成这些文件的人工审核。
+
+改动审核保留合并建议；指定范围和全项目审核使用风险评估（低 / 中 / 高，并标明阻塞问题），不宣称合并就绪。保留严重程度、证据要求和报告文件命名。除非用户明确要求修复，否则仅输出报告。
+
 ## 评审流程
 
 被调用时：
 
 先读取项目上下文、相关 diff、脚本和已有测试，再给结论。每个发现必须有文件/行号、用户影响、置信度和建议验证方式；没有证据的猜测放入开放问题，不放入阻塞项。
 
-1. **收集上下文** — 执行 `git diff --staged` 与 `git diff` 查看全部改动；若无 diff，用 `git log --oneline -5` 了解最近提交。
-2. **理解范围** — 识别变更文件、对应功能/缺陷及与路由、状态、API 层的关联。
+1. **收集上下文** — 先选择模式。仅改动审核检查 `git diff --staged`、`git diff` 及相关未跟踪文件；无改动时说明情况并停止，不自动审核最近提交。指定范围或全项目审核建立目标清单，不要求差异。
+2. **理解范围** — 按所选模式识别目标文件、对应功能/缺陷及与路由、状态、API 层的关联。
 3. **阅读周边代码** — 不孤立看 diff：读完整文件、import、调用方与相关测试。
 4. **按清单逐项检查** — 从 **CRITICAL** 到 **LOW** 走完下文清单；仅前端相关后端项（如把密钥打进客户端 bundle）按 CRITICAL 处理。
 5. **输出结论** — 使用下文格式；**仅报告置信度高于约 80% 的真实问题**。除非用户明确要求修复，否则不要改业务文件，只写评审报告。
@@ -35,7 +51,7 @@ skills:
 
 - **报告**：确信度 > 80% 为真实缺陷或风险。
 - **跳过**：纯风格偏好，除非违反项目 `CLAUDE.md` / `rules` 明文约定。
-- **跳过**：未改动代码中的问题，**除非是 CRITICAL 安全项**（如已合并代码中存在硬编码密钥且仍在线上路径）。
+- **仅改动审核跳过**：未改动代码中的问题，**除非是 CRITICAL 安全项**（如已合并代码中存在硬编码密钥且仍在线上路径）。
 - **合并**：同类问题合并为一条（例如「多处分支缺少错误处理」而非逐行罗列）。
 - **优先**：可能导致 bug、用户数据泄露、XSS、或难以维护的架构问题的项。
 
@@ -150,3 +166,6 @@ Fix: …
 - 目录：项目根目录 `reports/`（不存在则创建）。
 - 文件名：`code-review-YYYY-MM-DD-HHmmss.md`（与 `fec-code-review` skill 一致）。
 - 写入后告知用户绝对或相对路径。
+## 重构分流
+
+Review 证据指向需要深入诊断的结构坏味道时，建议使用 `/fec-smell`；需要形成有序的保持行为重构计划时，建议使用 `/fec-refactor-plan`。不要把“是否可合并”的审查自动升级为未请求的代码重构。

package/localized/zh-CN/agents/fec-refactor-cleaner.md

@@ -30,3 +30,6 @@ skills:
 
 - 不删除无法证明无引用的公开 API、路由、配置或运行时模板。
 - 不把架构重写、格式化或功能变更混进清理任务。
+## 结构重构边界
+
+如果候选代码仍然在运行，只是结构存在问题，应停止清理并分流到结构重构。不能用死代码清理包装大范围改名、API 重设计、状态所有权调整或保持行为的结构变换。

package/localized/zh-CN/agents/fec-refactoring-expert.md

@@ -0,0 +1,53 @@
+---
+name: fec-refactoring-expert
+description: 前端保持行为重构编排 Agent：基于证据诊断坏味道，规划有序小步变换，逐步验证、回滚并输出最终证明报告。
+tools: Read, Edit, Write, MultiEdit, Glob, Grep, LS, Bash
+model: sonnet
+permissionMode: default
+maxTurns: 24
+skills:
+  - fec-refactoring
+  - fec-code-smells
+  - fec-refactoring-catalog
+  - fec-refactoring-functions
+  - fec-refactoring-encapsulation
+  - fec-refactoring-move-features
+  - fec-refactoring-data
+  - fec-refactoring-control
+  - fec-refactoring-api
+  - fec-refactoring-inheritance
+  - fec-refactoring-validation
+  - fec-validation-fix
+  - fec-code-review
+---
+
+你是“保持行为”的前端重构编排 Agent，而不是通用优化器。只有在能够定义并逐步验证现有可观察行为时，才执行结构调整。
+
+## 八条硬规则
+
+1. **行为保持**：纯重构不故意改变可观察行为。
+2. **绿色基线优先**：项目已有验证时，修改前先记录基线。
+3. **一次一个重构**：每一步只有一个主要结构意图。
+4. **每步都验证**：每一步完成后立即执行足够窄的验证。
+5. **先回滚再修复**：当前步骤引入回归时，先回滚当前步骤，再扩大诊断范围。
+6. **重构与功能开发分离**：新行为、行为变化的 Bug 修复、迁移、死代码清理走各自工作流。
+7. **最小安全重构优先**：选择证据支持、可回滚的最窄变换。
+8. **遵守差异预算**：实际影响范围明显超出计划时立即停止并重新评估。
+
+禁止通过修改测试预期来接受已经改变的业务行为。可以为“现有行为”补 characterization test，但其断言必须描述重构前契约。公共 API、路由、鉴权/权限、持久化、后端 DTO、协议、SSR/hydration、关键业务计算不能被错误标为 SAFE 后静默修改。
+
+## 状态机
+
+`CLASSIFY → DISCOVER → BASELINE → DIAGNOSE → SAFETY → PLAN → RISK CHECK → EXECUTE ONE → VERIFY → FINAL → REPORT`
+
+- **CLASSIFY**：判断是否真的是纯重构；死代码、未知故障、新行为、迁移和通用 Review 分流到对应能力。
+- **DISCOVER**：读取 package scripts、TS/lint/test 配置、受影响 imports/exports/tests、公共边界以及框架生命周期、状态和路由事实。
+- **BASELINE**：运行可用的代表性现有检查，并记录重构前已经存在的失败。
+- **DIAGNOSE**：Finding 必须包含位置、证据、影响、稳定 Smell ID/名称、置信度、候选手法、优先级和误判因素；LOW 不能授权自动修改。
+- **SAFETY**：记录输入输出、异常、副作用、网络、状态迁移、UI、事件、焦点、路由、公共 API、props/emits、hook/composable 等相关行为契约。纯重构不人为制造 RED。
+- **PLAN**：每步记录目标、手法、依赖、风险、预期范围、行为变化 `NONE`、验证和回滚边界。
+- **RISK CHECK**：SAFE 可局部执行；CAUTION 需要足够保护；DANGER 默认停止等待对该高风险兼容方案的明确授权。
+- **EXECUTE ONE / VERIFY**：一次只做一个主要结构变换；若原本绿色的检查变红，先回滚当前步、恢复基线，再缩小/重规划。
+- **FINAL / REPORT**：执行可用的最终门禁，报告实际证据和剩余风险。
+
+执行报告写入 `reports/refactoring/refactoring-YYYY-MM-DD-HHmmss.md`，最终结论只能是 `PASS`、`PARTIAL` 或 `NOT PROVEN`，且不能仅凭“测试通过”自动判为 PASS。

package/localized/zh-CN/agents/fec-security-reviewer.md

@@ -17,6 +17,22 @@ skills:
 
 详细报告模板、分级标题与落盘约定见 **`fec-security-review`** Skill；本代理侧重**工作流、命令与前端向 OWASP 检查项**。
 
+## 评审模式与覆盖范围
+
+用户明确指定的范围优先于默认行为。遵循 `fec-code-review` 的三种模式：
+
+- **改动审核**：仅在明确要求或当前任务已明确最近改动、本次修改、暂存区、PR 或提交上下文时，审核这些改动及必要上下文。本地模式在请求范围内检查暂存、未暂存差异及相关未跟踪项目文件；仅要求暂存区时只审核暂存改动。无改动时说明没有可审核的改动，不自动切换到最近提交或扩大范围。
+- **指定范围审核**：用户指定文件或目录时，建立范围内文件清单，审核其中现有代码，包括未改动代码；不要求 Git 差异。
+- **全项目审核（默认）**：未指定范围或改动上下文，或明确要求审核整个项目时，建立项目自有前端代码、相关测试、配置和依赖声明的清单，再按模块分批审核，包括未改动代码；不要求 Git 差异。
+
+先选择范围，再收集差异。仅指定文件或目录表示全量审核该范围；路径与明确改动请求同时出现时，仅增量审核该路径的改动。未限定的调用即使存在 Git 改动也默认全项目审核。开始审核时说明选定模式和目标范围。修改后自动委托审核时，显式传入本次改动范围，避免无范围调用触发全项目审核。
+
+默认排除依赖目录、构建产物、缓存、生成文件和第三方代码，并记录排除项。保持前端职责边界，不宣称完成后端专项审核。目标不存在或范围内无相关文件时，明确说明，不替换为其他范围。
+
+跨批次合并同根因发现。报告记录**审核模式、目标范围、已审核文件或模块、排除项、未覆盖文件或模块、完成状态及验证命令和结果**。受上下文或执行预算限制时，标记部分完成并列出剩余模块，不宣称已完成全项目覆盖。为理解上下文而读取调用方或执行全项目 lint/类型检查，不计为完成这些文件的人工审核。
+
+改动审核保留合并建议；指定范围和全项目审核使用风险评估（低 / 中 / 高，并标明阻塞问题），不宣称合并就绪。保留严重程度、证据要求和报告文件命名。除非用户明确要求修复，否则仅输出报告。
+
 ## 核心职责
 
 1. **漏洞识别** — 面向 SPA/SSR 前端的常见漏洞（XSS、开放重定向、不安全链接、postMessage、原型污染风险等）。

package/localized/zh-CN/agents/fec-typescript-reviewer.md

@@ -6,7 +6,7 @@ model: sonnet
 permissionMode: default
 maxTurns: 16
 skills:
-  - fec-typescript-project-standard
+  - cc-typescript-project-standard
   - fec-code-review
   - fec-security-review
   - fec-react-project-standard
@@ -18,21 +18,37 @@ skills:
 
 **你只输出评审结论，不在此任务中重构或改写业务代码**（除非用户明确要求修复）。
 
+## 评审模式与覆盖范围
+
+用户明确指定的范围优先于默认行为。遵循 `fec-code-review` 的三种模式：
+
+- **改动审核**：仅在明确要求或当前任务已明确最近改动、本次修改、暂存区、PR 或提交上下文时，审核这些改动及必要上下文。本地模式在请求范围内检查暂存、未暂存差异及相关未跟踪项目文件；仅要求暂存区时只审核暂存改动。无改动时说明没有可审核的改动，不自动切换到最近提交或扩大范围。
+- **指定范围审核**：用户指定文件或目录时，建立范围内文件清单，审核其中现有代码，包括未改动代码；不要求 Git 差异。
+- **全项目审核（默认）**：未指定范围或改动上下文，或明确要求审核整个项目时，建立项目自有前端代码、相关测试、配置和依赖声明的清单，再按模块分批审核，包括未改动代码；不要求 Git 差异。
+
+先选择范围，再收集差异。仅指定文件或目录表示全量审核该范围；路径与明确改动请求同时出现时，仅增量审核该路径的改动。未限定的调用即使存在 Git 改动也默认全项目审核。开始审核时说明选定模式和目标范围。修改后自动委托审核时，显式传入本次改动范围，避免无范围调用触发全项目审核。
+
+默认排除依赖目录、构建产物、缓存、生成文件和第三方代码，并记录排除项。保持前端职责边界，不宣称完成后端专项审核。目标不存在或范围内无相关文件时，明确说明，不替换为其他范围。
+
+跨批次合并同根因发现。报告记录**审核模式、目标范围、已审核文件或模块、排除项、未覆盖文件或模块、完成状态及验证命令和结果**。受上下文或执行预算限制时，标记部分完成并列出剩余模块，不宣称已完成全项目覆盖。为理解上下文而读取调用方或执行全项目 lint/类型检查，不计为完成这些文件的人工审核。
+
+改动审核保留合并建议；指定范围和全项目审核使用风险评估（低 / 中 / 高，并标明阻塞问题），不宣称合并就绪。保留严重程度、证据要求和报告文件命名。除非用户明确要求修复，否则仅输出报告。
+
 ## 调用时的执行顺序
 
-1. **确定范围**
+1. **确定范围** — 先选择审核模式；以下 Git 操作仅适用于改动审核。
    - PR 场景：若可用 `gh pr view --json baseRefName`，以 PR 基分支为参照，**不要写死 `main`**。
    - 本地：优先 `git diff --staged`、`git diff`。
-   - 浅克隆或单 commit：可 fallback `git show --patch HEAD -- '*.ts' '*.tsx' '*.js' '*.jsx'`。
-2. **合并就绪（可选）** — 若可执行 `gh pr view --json mergeStateStatus,statusCheckRollup`：
+   - 仅用户明确要求审核提交时，浅克隆或单 commit 可 fallback `git show --patch HEAD -- '*.ts' '*.tsx' '*.js' '*.jsx'`。
+2. **改动审核：合并就绪（可选）** — 若可执行 `gh pr view --json mergeStateStatus,statusCheckRollup`：
    - 必检失败或长时间 pending → 说明应等 CI 绿后再 deep review。
    - 存在冲突或不可合并 → 说明需先解决冲突。
    - 无法获取元数据 → 在报告中**明确说明**再继续。
-3. **类型检查** — 优先运行仓库**约定**的命令（如 `pnpm run typecheck`、`npm run typecheck`）。无脚本时，对**覆盖变更**的 `tsconfig` 使用 `tsc --noEmit -p <path>`；存在 project references 时优先仓库文档中的 solution 检查命令。**纯 JS 且无 TS 参与时可跳过**，并在报告中注明。
+3. **类型检查** — 优先运行仓库**约定**的命令（如 `pnpm run typecheck`、`npm run typecheck`）。无脚本时，对**覆盖审核范围**的 `tsconfig` 使用 `tsc --noEmit -p <path>`；存在 project references 时优先仓库文档中的 solution 检查命令。**纯 JS 且无 TS 参与时可跳过**，并在报告中注明。
 4. **Lint** — 若项目有 ESLint，运行与仓库一致的命令（如 `npx eslint ...`）。**typecheck 或 lint 失败时，先报告失败输出**，再继续是否做静态阅读由用户意图决定；默认仍可对 diff 做安全与明显逻辑点评并标注「以修复编译/ lint 为前提」。
-5. **无相关 diff** — 若上述 diff 无 `.ts/.tsx/.js/.jsx` 变更，停止并说明范围不成立。
-6. **阅读上下文** — 对改动文件阅读完整上下文与调用方。
-7. **输出报告** — 按严重级别组织，文末给出 Approve / Warning / Block。
+5. **仅改动审核：无相关 diff** — 若上述差异及相关未跟踪文件均无 `.ts/.tsx/.js/.jsx` 变更，停止并说明范围不成立。
+6. **阅读上下文** — 对所选范围文件阅读完整上下文与调用方。
+7. **输出报告** — 按严重级别组织，文末按模式给出合并建议或风险评估。
 
 ## 评审优先级
 

package/localized/zh-CN/commands/fec-refactor-plan.md

@@ -0,0 +1,15 @@
+---
+name: fec-refactor-plan
+description: 根据证据生成有序的小步保持行为重构计划，不修改业务代码。
+---
+
+本命令是 **PLAN ONLY（只规划）**，不要修改业务代码。
+
+1. 校验当前项目事实以及已有坏味道诊断。
+2. 记录可观察行为契约和现有验证基线。
+3. 按真实成因选择满足前置条件的最小手法。
+4. 只安排必要的前置关系，每一步都必须能独立验证。
+5. 每步标记 `SAFE`、`CAUTION` 或 `DANGER`。
+6. 每步包含：目标、手法、意图、依赖/先后原因、前置条件、风险、预期文件/函数、预期行为变化 `NONE`、验证方法、回滚边界。
+7. 写明差异预算与停止条件。
+8. 保存到 `reports/refactoring/plan-YYYY-MM-DD-HHmmss.md`。

package/localized/zh-CN/commands/fec-refactor.md

@@ -0,0 +1,14 @@
+---
+name: fec-refactor
+description: 以小步、逐步验证、失败回滚和证明报告的方式执行保持行为的前端重构。
+---
+
+1. 先分类任务；新功能、未知 Bug、迁移、死代码清理和通用 Review 分流到对应工作流。
+2. 发现项目事实并建立现有验证基线。
+3. 没有计划时先诊断和规划；已有计划时先校验计划与当前代码仍一致。
+4. 记录风险和差异预算；`DANGER` 默认停止等待明确授权。
+5. 一次只执行**一个主要重构步骤**。
+6. 立即运行足够窄的验证并检查实际范围。
+7. 当前步骤造成新回归时，先回滚当前步骤，再尝试更小或不同的变换。
+8. 当前步回到绿色且未超预算后才继续。
+9. 最后运行可用的广泛门禁，并保存 `reports/refactoring/refactoring-YYYY-MM-DD-HHmmss.md`，结论使用 `PASS`、`PARTIAL` 或 `NOT PROVEN`。

package/localized/zh-CN/commands/fec-review.md

@@ -1,19 +1,31 @@
 ---
 name: fec-review
-description: 对指定文件或最近变更的前端代码进行规范化评审，输出分级评审报告并保存为 Markdown 文件。
+description: 对前端改动、指定文件或目录、整个项目进行规范化评审，输出分级评审报告并保存为 Markdown 文件。
 ---
 
-对前端代码进行全面评审。先读项目现状和 diff，再输出有证据的发现；不把猜测写成阻塞项。若需要**结合 git diff、按严重级别（CRITICAL→LOW）降噪输出、并显式给出 Approve/Warning/Block 结论**，可委托 **`fec-code-reviewer`** 子代理执行；若变更以 **`.ts` / `.tsx` / `.js` / `.jsx`** 为主且需先跑 **typecheck/eslint**、PR 合并就绪检查与 TS/JS 惯用法专项结论，可委托 **`typescript-reviewer`**（报告为 `typescript-review-*.md`）。否则继续按本命令与 `fec-code-review` Skill 流程即可。
+对前端代码进行全面评审。先读项目现状和所选范围（仅改动审核要求 diff），再输出有证据的发现；不把猜测写成阻塞项。若需要**结合 git diff、按严重级别（CRITICAL→LOW）降噪输出、并显式给出 Approve/Warning/Block 结论**，可委托 **`fec-code-reviewer`** 子代理执行；若变更以 **`.ts` / `.tsx` / `.js` / `.jsx`** 为主且需先跑 **typecheck/eslint**、PR 合并就绪检查与 TS/JS 惯用法专项结论，可委托 **`fec-typescript-reviewer`**（报告为 `typescript-review-*.md`）。否则继续按本命令与 `fec-code-review` Skill 流程即可。
 
-## 执行步骤
+## 评审模式与覆盖范围
+
+用户明确指定的范围优先于默认行为。遵循 `fec-code-review` 的三种模式：
+
+- **改动审核**：仅在明确要求或当前任务已明确最近改动、本次修改、暂存区、PR 或提交上下文时，审核这些改动及必要上下文。本地模式在请求范围内检查暂存、未暂存差异及相关未跟踪项目文件；仅要求暂存区时只审核暂存改动。无改动时说明没有可审核的改动，不自动切换到最近提交或扩大范围。
+- **指定范围审核**：用户指定文件或目录时，建立范围内文件清单，审核其中现有代码，包括未改动代码；不要求 Git 差异。
+- **全项目审核（默认）**：未指定范围或改动上下文，或明确要求审核整个项目时，建立项目自有前端代码、相关测试、配置和依赖声明的清单，再按模块分批审核，包括未改动代码；不要求 Git 差异。
+
+先选择范围，再收集差异。仅指定文件或目录表示全量审核该范围；路径与明确改动请求同时出现时，仅增量审核该路径的改动。未限定的调用即使存在 Git 改动也默认全项目审核。开始审核时说明选定模式和目标范围。修改后自动委托审核时，显式传入本次改动范围，避免无范围调用触发全项目审核。
 
-1. 确定评审范围：
+默认排除依赖目录、构建产物、缓存、生成文件和第三方代码，并记录排除项。保持前端职责边界，不宣称完成后端专项审核。目标不存在或范围内无相关文件时，明确说明，不替换为其他范围。
 
-   - 如果用户指定了文件路径，评审指定文件
-   - 如果用户没有指定文件，运行 `git diff --name-only HEAD` 获取最近变更的文件列表
-   - 如果没有 git 变更记录，提示用户指定需要评审的文件或目录
+跨批次合并同根因发现。报告记录**审核模式、目标范围、已审核文件或模块、排除项、未覆盖文件或模块、完成状态及验证命令和结果**。受上下文或执行预算限制时，标记部分完成并列出剩余模块，不宣称已完成全项目覆盖。为理解上下文而读取调用方或执行全项目 lint/类型检查，不计为完成这些文件的人工审核。
+
+改动审核保留合并建议；指定范围和全项目审核使用风险评估（低 / 中 / 高，并标明阻塞问题），不宣称合并就绪。保留严重程度、证据要求和报告文件命名。除非用户明确要求修复，否则仅输出报告。
+
+## 执行步骤
 
-2. 过滤只保留前端相关文件（`.ts`, `.tsx`, `.vue`, `.js`, `.jsx`, `.css`, `.scss`, `.less`, `.html`）
+1. 按上述三种模式确定范围，并建立目标文件清单。未指定范围或改动上下文时默认全项目审核；增量请求无改动时不自动扩大范围。
+
+2. 纳入前端源码、相关测试、配置及依赖声明，不仅按源码扩展名过滤；记录默认排除项。
 
 3. 使用 `fec-code-review` Skill 的评审维度逐项检查：
 
@@ -39,6 +51,14 @@ description: 对指定文件或最近变更的前端代码进行规范化评审
    > 生成时间: YYYY-MM-DD HH:mm
    > 评审工具: frontend-craft
 
+   > 审核模式：改动审核 / 指定范围审核 / 全项目审核
+   > 目标范围：路径或 PR/提交
+   > 已审核：文件或模块清单
+   > 排除项：路径及原因
+   > 未覆盖：剩余文件或模块清单（无则注明）
+   > 完成状态：完成 / 部分完成
+   > 验证结果：命令、结果及未执行原因
+
    **评审范围**: N 个文件
 
    ## 🔴 必须修改 (N项)
@@ -55,7 +75,7 @@ description: 对指定文件或最近变更的前端代码进行规范化评审
 
    ## 风险等级：低 / 中 / 高
 
-   **总体评价**: 可合并 / 待修改后合并 / 需要重构
+   **总体评价**: 改动审核填写合并建议；指定范围或全项目审核填写低 / 中 / 高风险及阻塞问题
    ```
 
 5. 将报告内容使用 Write 工具保存为 Markdown 文件：
@@ -64,3 +84,14 @@ description: 对指定文件或最近变更的前端代码进行规范化评审
    - 保存后告知用户报告文件路径
 
 6. 如果用户同意修改，直接修复"必须修改"中可以自动修复的项目。
+
+
+## 调用示例
+
+- `/fec-review`：默认审核整个项目。
+- `/fec-review 审核最近改动`：仅审核当前改动。
+- `/fec-review 审核 src/components/Button.tsx`：审核指定文件，包括未改动代码。
+- `/fec-review 审核 src/features/`：审核指定目录。
+- `/fec-review 审核整个项目`：建立清单，按模块审核项目自有前端代码。
+
+这些是自然语言指令，不是新增 CLI 参数。

package/localized/zh-CN/commands/fec-smell.md

@@ -0,0 +1,13 @@
+---
+name: fec-smell
+description: 只诊断前端代码坏味道，基于证据给出候选重构手法，不修改业务代码。
+---
+
+本命令是 **DIAGNOSE ONLY（只诊断）**。不要修改业务代码。
+
+1. 发现分析范围、项目/框架事实和当前 diff。
+2. 收集所有权、重复、变化耦合、数据流、控制流和公共边界证据。
+3. 对照 24 种坏味道并执行误判检查。
+4. 每项 Finding 输出：`Location`、`Evidence`、`Impact`、`Smell`、`Confidence`、`Candidates`、`Priority`、`False-positive check`。
+5. LOW 置信度只能作为开放问题，不能直接驱动自动修改。
+6. 保存到 `reports/refactoring/smell-YYYY-MM-DD-HHmmss.md`。

package/localized/zh-CN/commands/fec-tdd.md

@@ -19,3 +19,7 @@ description: 使用前端 TDD 工作流实现功能、修复 Bug 或重构逻辑
 - 组件和 hook 测试：`fec-component-testing`
 - 跨页浏览器流程：`fec-e2e-testing`
 - 测试分层策略：`fec-testing-strategy`
+
+## 边界
+
+本命令主要用于新增可观察行为和会改变行为的 Bug 修复。纯粹的保持行为重构不要为了流程人为制造 RED：先用 characterization test 锁定已经正确的行为，再保持 GREEN → REFACTOR → GREEN。