@bovinphang/frontend-craft 2.5.0 → 2.6.0

package/docs/runtimes/claude.zh-CN.md

@@ -5,9 +5,9 @@
 仅当你需要跨运行时安装、离线/脚本化复制文件，或处在非 Marketplace 环境时，再使用 CLI：
 
 ```bash
-npx frontend-craft@latest install --local claude
+npx @bovinphang/frontend-craft@latest install --local claude
 # 或
-npx frontend-craft@latest install --global claude
+npx @bovinphang/frontend-craft@latest install --global claude
 ```
 
 > **非交互场景：** 请加上 `--local` 或 `--global`，避免询问安装位置。交互与脚本行为说明见根目录 README **通用安装**。
@@ -22,6 +22,8 @@ CLI 会对 Marketplace 安装执行单一来源保护：如果已经由 Claude C
 
 仍可将 `frontend-craft` 作为 Claude Code 的 Marketplace 插件安装，由 Claude Code 原生加载插件。
 
+Marketplace 条目会从已发布的 npm 包解析插件；npm 包中包含 Claude hooks 使用的已编译 `dist/hooks/*.js` 运行时文件。如果 Marketplace 安装后提示缺少 `dist/hooks/fec-*.js`，请通过 Marketplace 更新或重新安装插件，让 Claude 刷新插件缓存，不建议手动复制文件到缓存目录。
+
 ---
 
 ## Marketplace 安装后的快速开始
@@ -33,7 +35,7 @@ CLI 会对 Marketplace 安装执行单一来源保护：如果已经由 Claude C
 /plugin marketplace add bovinphang/frontend-craft
 
 # 安装插件
-/plugin install frontend-craft@bovinphang-frontend-craft
+/plugin install frontend-craft@frontend-craft
 
 # 激活
 /reload-plugins
@@ -67,7 +69,7 @@ CLI 会对 Marketplace 安装执行单一来源保护：如果已经由 Claude C
 /fec-scaffold component DataTable
 
 # 查看可用命令
-/plugin list frontend-craft@bovinphang-frontend-craft
+/plugin list frontend-craft@frontend-craft
 ```
 
 具体 agents、skills、commands 清单见根目录 README **功能概览**。
@@ -105,10 +107,14 @@ CLI 会对 Marketplace 安装执行单一来源保护：如果已经由 Claude C
 
 ```bash
 git clone https://github.com/bovinphang/frontend-craft.git
+cd frontend-craft
+npm install
+npm run build
+cd ..
 claude --plugin-dir ./frontend-craft
 ```
 
-使用 `--plugin-dir` 做开发调试时，请避免在同一会话里同时启用 Marketplace 版本，这样才能确定当前运行的是哪一份代码。
+使用 `--plugin-dir` 做开发调试时，修改 hooks 或 CLI 源码后需要重新执行 `npm run build`，因为 Claude 会运行 `dist/` 下的已编译文件。请避免在同一会话里同时启用 Marketplace 版本，这样才能确定当前运行的是哪一份代码。
 
 ### 选项 4：Git Submodule（项目内共享）
 
@@ -139,14 +145,14 @@ claude --plugin-dir .claude/plugins/frontend-craft
 通过 Marketplace 安装的插件，在 Claude Code 中执行：
 
 ```text
-/plugin marketplace update bovinphang-frontend-craft
+/plugin marketplace update frontend-craft
 ```
 
 或开启自动更新，每次启动 Claude Code 时拉取最新版本：
 
 1. 在 Claude Code 中执行 `/plugin` 打开插件管理器
 2. 切换到 **Marketplaces** 标签页
-3. 选中 `bovinphang-frontend-craft`
+3. 选中 `frontend-craft`
 4. 选择 **Enable auto-update**
 
 > 第三方 Marketplace 默认不开启自动更新。启用后，Claude Code 每次启动时会刷新 Marketplace 数据并更新已安装插件。
@@ -157,11 +163,11 @@ claude --plugin-dir .claude/plugins/frontend-craft
 git submodule update --remote .claude/plugins/frontend-craft
 ```
 
-**CLI 安装：** 对同一作用域执行 `npx frontend-craft@latest update claude --local` 或 `... --global`，版本说明见 [CHANGELOG.zh-CN.md](../../CHANGELOG.zh-CN.md) 或 [CHANGELOG.md](../../CHANGELOG.md)。如果已经检测到 Claude Code Marketplace 安装，CLI 会拒绝 Claude install/update，并提示通过 Marketplace 更新。如果另一个 CLI 作用域已安装，交互式终端会询问是保持该来源并更新，还是卸载后切换；非交互终端会打印可执行命令。
+**CLI 安装：** 对同一作用域执行 `npx @bovinphang/frontend-craft@latest update claude --local` 或 `... --global`，版本说明见 [CHANGELOG.zh-CN.md](../../CHANGELOG.zh-CN.md) 或 [CHANGELOG.md](../../CHANGELOG.md)。如果已经检测到 Claude Code Marketplace 安装，CLI 会拒绝 Claude install/update，并提示通过 Marketplace 更新。如果另一个 CLI 作用域已安装，交互式终端会询问是保持该来源并更新，还是卸载后切换；非交互终端会打印可执行命令。
 
 ```bash
-npx frontend-craft@latest update claude --global
-npx frontend-craft@latest update claude --local
+npx @bovinphang/frontend-craft@latest update claude --global
+npx @bovinphang/frontend-craft@latest update claude --local
 ```
 
 ---

package/docs/runtimes/cline.md

@@ -3,7 +3,7 @@
 See root README **Universal Install** and run:
 
 ```bash
-npx frontend-craft install cline
+npx @bovinphang/frontend-craft install cline
 ```
 
 > **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.

package/docs/runtimes/codebuddy.md

@@ -3,7 +3,7 @@
 See root README **Universal Install** and run:
 
 ```bash
-npx frontend-craft install codebuddy
+npx @bovinphang/frontend-craft install codebuddy
 ```
 
 > **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.

package/docs/runtimes/codex.md

@@ -3,7 +3,7 @@
 See root README **Universal Install** and run:
 
 ```bash
-npx frontend-craft install codex
+npx @bovinphang/frontend-craft install codex
 ```
 
 > **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.

package/docs/runtimes/copilot.md

@@ -3,7 +3,7 @@
 See root README **Universal Install** and run:
 
 ```bash
-npx frontend-craft install copilot
+npx @bovinphang/frontend-craft install copilot
 ```
 
 > **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.

package/docs/runtimes/cursor.md

@@ -3,7 +3,7 @@
 See root README **Universal Install** and run:
 
 ```bash
-npx frontend-craft install cursor
+npx @bovinphang/frontend-craft install cursor
 ```
 
 > **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.

package/docs/runtimes/gemini.md

@@ -3,7 +3,7 @@
 See root README **Universal Install** and run:
 
 ```bash
-npx frontend-craft install gemini
+npx @bovinphang/frontend-craft install gemini
 ```
 
 > **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.

package/docs/runtimes/kilo.md

@@ -3,7 +3,7 @@
 See root README **Universal Install** and run:
 
 ```bash
-npx frontend-craft install kilo
+npx @bovinphang/frontend-craft install kilo
 ```
 
 > **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.

package/docs/runtimes/openclaw.md

@@ -3,7 +3,7 @@
 See root README **Universal Install** and run:
 
 ```bash
-npx frontend-craft install openclaw
+npx @bovinphang/frontend-craft install openclaw
 ```
 
 > **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.

package/docs/runtimes/opencode.md

@@ -3,7 +3,7 @@
 See root README **Universal Install** and run:
 
 ```bash
-npx frontend-craft install opencode
+npx @bovinphang/frontend-craft install opencode
 ```
 
 > **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.

package/docs/runtimes/qoder.md

@@ -3,7 +3,7 @@
 See root README **Universal Install** and run:
 
 ```bash
-npx frontend-craft install qoder
+npx @bovinphang/frontend-craft install qoder
 ```
 
 > **Non-interactive:** append `--local` or `--global` to skip install-location prompts. Local installs write to `.qoder/`; global installs write to `~/.qoder` or `QODER_CONFIG_DIR`.

package/docs/runtimes/trae.md

@@ -3,7 +3,7 @@
 See root README **Universal Install** and run:
 
 ```bash
-npx frontend-craft install trae
+npx @bovinphang/frontend-craft install trae
 ```
 
 > **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.

package/docs/runtimes/windsurf.md

@@ -3,7 +3,7 @@
 See root README **Universal Install** and run:
 
 ```bash
-npx frontend-craft install windsurf
+npx @bovinphang/frontend-craft install windsurf
 ```
 
 > **Non-interactive:** append `--local` or `--global` to skip install-location prompts. See the repository README **Universal Install** for interactive vs. scripted behavior.

package/docs/zh-CN/example-prompts.md

@@ -17,7 +17,7 @@
 | 初始化项目规则   | 「请用 frontend-craft 为当前运行时初始化这个仓库的项目模板；如果已有文件，覆盖前先询问我。」                          | `/fec-init`                  | 安装运行时配置、规则和项目说明，或给出覆盖方案。 | 最好在业务仓库根目录执行。 |
 | 选择安装位置     | 「我想在这台机器上同时给 Codex 和 Claude Code 使用 frontend-craft。请说明应该本地安装还是全局安装，并给出准确命令。」 | runtime docs                 | 简短建议和安装命令。                             | 说明个人使用还是团队共享。 |
 | 学会怎么提问     | 「请根据这个仓库给我 5 条 frontend-craft 提示词，分别用于评审、开发、测试、排查构建失败和设计稿实现。」               | 文档指引                     | 贴合当前项目的提示词集合。                       | 安装后第一次使用很适合。   |
-| 确认能力是否可用 | 「请检查这个仓库，并总结当前可用的 frontend-craft commands、skills、agents、hooks 和 MCP 模板。」                     | `fec-doc-sync`、runtime docs | 基于已安装文件的能力摘要。                       | 升级后很有用。             |
+| 确认能力是否可用 | 「请检查这个仓库，并总结当前可用的 frontend-craft commands、skills、agents、hooks 和 MCP 模板。」                     | runtime docs                 | 基于已安装文件的能力摘要。                       | 升级后很有用。             |
 
 ## 评审与质量
 
@@ -103,7 +103,8 @@
 | ------------ | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------- | ---------------------------------- |
 | 修复构建失败 | 「`pnpm lint`、`pnpm typecheck` 和 `pnpm test` 都失败了。请逐步修复，不要放宽规则或跳过测试。」                           | `/fec-build-fix`、`fec-validation-fix`、`fec-build-fixer`                 | 最小修复和验证报告。                         | 粘贴准确失败命令。                 |
 | 清理死代码   | 「请查找并安全移除未使用导出、死路由、过期样式和未使用依赖。保持 public API，并写报告。」                                 | `/fec-refactor-clean`、`fec-refactor-clean`、`fec-refactor-cleaner`       | 清理计划/变更和报告。                        | 发布前很适合。                     |
-| 文档同步     | 「请更新公开文档，让 README、runtime docs、能力表和 metadata 与当前 commands、skills、agents、hooks、package 文件一致。」 | `/fec-doc-sync`、`fec-doc-sync`、`fec-doc-updater`                        | 同步后的文档和验证说明。                     | 不要把临时报告复制进公开文档。     |
+| 文档同步     | 「请更新 README 和 docs，让安装步骤、脚本、环境变量、API 路由、UI 路由和部署说明与当前前端代码和配置一致。」             | `/fec-doc-sync`、`fec-doc-sync`、`fec-doc-updater`                        | 同步后的文档和验证说明。                     | 不要把临时报告复制进公开文档。     |
+| 能力文档同步 | 「这个仓库发布 skills 和 commands。请同步能力表、metadata、runtime docs 和 package 文件，使其匹配已安装内容。」          | `/fec-doc-sync`、`fec-doc-sync`、`fec-doc-updater`                        | 基于已安装文件的分发文档。                   | 用于 skill/agent/command 仓库。     |
 | 来源驱动升级 | 「请规划 React Router/TanStack Query/Vite 的安全升级。核对官方迁移说明、当前项目用法、破坏性变更，并给出验证步骤。」      | `fec-dependency-upgrade`、`fec-source-driven-development`、`fec-doc-sync` | 升级决策说明、影响文件、迁移风险和验证清单。 | 如果公开指南变化，再配合文档同步。 |
 | 遗留项目维护 | 「请改进 `public/js/legacy/cart.js`，保持当前 jQuery/MPA 技术栈，降低风险、改善结构，但暂时不要重写成 React。」           | `fec-legacy-web-standard`                                                 | 安全的遗留维护变更或建议。                   | 补充浏览器兼容限制。               |
 
@@ -120,5 +121,5 @@
 | 斜杠命令 TDD     | 「`/fec-tdd` 请用失败测试优先的方式添加密码强度校验。」                                               | `/fec-tdd`            | TDD 循环和已验证改动。          | 保持范围小。                          |
 | 斜杠命令构建修复 | 「`/fec-build-fix` 请根据这段日志修复验证失败：<粘贴日志>。」                                         | `/fec-build-fix`      | 增量验证修复。                  | 粘贴准确日志。                        |
 | 斜杠命令清理     | 「`/fec-refactor-clean` 请安全移除这个包里的未使用导出和依赖。」                                      | `/fec-refactor-clean` | 清理报告和安全修改。            | 修改后运行测试。                      |
-| 斜杠命令文档同步 | 「`/fec-doc-sync` 请同步 README、runtime docs 和 metadata，使其匹配当前包内容。」                     | `/fec-doc-sync`       | 文档更新和验证说明。            | 发布前使用。                          |
+| 斜杠命令文档同步 | 「`/fec-doc-sync` 请同步 README、docs、env examples、脚本、API/路由说明和部署文档，使其匹配当前项目。」 | `/fec-doc-sync`       | 文档更新和验证说明。            | 发布前使用。                          |
 | 显式代理         | 「请委托 `fec-code-reviewer` 对 `src/features/payments/` 做 PR 风格评审，然后先总结阻塞项。」         | agent dispatch        | 专项代理报告和摘要。            | 适合专家评审。                        |

package/docs/zh-TW/README.md

@@ -8,7 +8,7 @@
 
 [![Stars](https://img.shields.io/github/stars/bovinphang/frontend-craft?style=flat)](https://github.com/bovinphang/frontend-craft/stargazers)
 [![CI](https://github.com/bovinphang/frontend-craft/actions/workflows/ci.yml/badge.svg)](https://github.com/bovinphang/frontend-craft/actions/workflows/ci.yml)
-[![npm version](https://img.shields.io/npm/v/frontend-craft)](https://www.npmjs.com/package/frontend-craft)
+[![npm version](https://img.shields.io/npm/v/@bovinphang/frontend-craft)](https://www.npmjs.com/package/@bovinphang/frontend-craft)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](../../LICENSE)
 ![Node](https://img.shields.io/badge/Node.js-22+-5FA04E?logo=node.js&logoColor=white)
 ![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript&logoColor=white)
@@ -32,7 +32,7 @@
 
 各執行時的路徑與注意事項詳見 [`docs/runtimes/`](../runtimes/)。
 
-它將 **13 個專業 agent**、**40 個自動啟用 skill**、**8 個斜線指令**、**5 個事件驅動 hook**、面向 6 個設計工具端點的 **MCP 整合**以及一整套**規則庫**打包為一個可安裝單元。執行一條指令，團隊裡的每一次 AI 會話都將以相同的方式編寫 React、Vue、Next.js 或 Nuxt——型別安全、可存取、安全、一致。
+它將 **13 個專業 agent**、**41 個自動啟用 skill**、**8 個斜線指令**、**5 個事件驅動 hook**、面向 6 個設計工具端點的 **MCP 整合**以及一整套**規則庫**打包為一個可安裝單元。執行一條指令，團隊裡的每一次 AI 會話都將以相同的方式編寫 React、Vue、Next.js 或 Nuxt——型別安全、可存取、安全、一致。
 
 ---
 
@@ -40,7 +40,7 @@
 
 | 痛點                                            | frontend-craft 的解法                                                                   |
 | ----------------------------------------------- | --------------------------------------------------------------------------------------- |
-| AI 助手寫出的前端程式碼風格不一、缺型別、不安全 | **40 個 skill** 將團隊規範編碼為可自動啟用的工作流                                      |
+| AI 助手寫出的前端程式碼風格不一、缺型別、不安全 | **41 個 skill** 將團隊規範編碼為可自動啟用的工作流                                      |
 | 每款 AI 工具都有自己的插件格式                  | **一條 CLI 指令** 把相同的規則、agent 和 hook 安裝到 15 個執行時                        |
 | 設計稿到程式碼的交接總有資訊損失                | **MCP 整合** 從 Figma、Figma Desktop、Sketch、MasterGo、Pixso、墨刀引入更完整設計上下文 |
 | 程式碼審查隨意、淺層                            | **13 個 agent** 輸出分級報告：程式碼、安全、無障礙、效能、TS、UI 還原度                 |
@@ -53,45 +53,59 @@
 
 需要 **Node.js 22+**。完整支援 **Windows、macOS 和 Linux**（所有鉤子和腳本均使用 Node.js 實作）。
 
-### 方式一：全域 CLI 初始化專案（推薦）
+### 方式一：全域安裝 fec CLI（推薦）
 
 ```bash
-npm install -g frontend-craft@latest
+# 1. 全域安裝 fec 指令
+npm install -g @bovinphang/frontend-craft@latest
+
+# 2. 進入你的前端專案
 cd your-project
-fec init
-fec init codex      # 初始化指定執行時
-fec init claude     # 初始化 Claude Code
-```
 
-`fec init` 是終端機中的 CLI 初始化指令，用來初始化目前專案。在互動式終端機中，不傳 runtime 時會顯示選擇提示；在非互動環境中，不傳 runtime 時 CLI 預設使用 `claude`。`init` 預設安裝到目前專案，除非明確傳入 `--global`，例如 `fec init codex --global`。AI 助手內的 `/fec-init` 斜線指令是另一個入口，需要先把 frontend-craft 安裝到對應執行時後再使用。
+# 3. 互動選擇要接入的 AI 執行時
+fec setup
 
-### 方式二：免全域安裝的互動精靈
+# 4. 接入目前專案
+fec setup codex
+fec setup claude
+fec setup all
 
-```bash
-npx frontend-craft@latest
+# 5. 全域接入，適用於所有專案
+fec setup codex --global
+fec setup claude --global
+fec setup all --global
+
+# 6. 預覽 / 查詢
+fec install --all --dry-run --global
+fec list
 ```
 
-不想全域安裝 `fec` 指令時使用這種方式。精靈會走完整安裝流程：先選擇一個或多個執行時，再決定安裝到全域還是目前專案。
+`npm install -g` 只是安裝 `fec` 終端機指令。`fec setup` 是終端機中的 CLI 專案接入指令，不是 AI 助手內的 `/fec-init` 斜線指令。在互動式終端機中，不帶參數的 `fec setup` 會先讓你選擇 runtime；`fec setup <runtime>` 和 `fec setup all` 會預設接入目前專案。只有傳入 `--global` 時，才會接入對應 AI 工具的全域設定目錄，適用於所有專案。
 
-### 方式三：腳本化安裝
+### 方式二：用 npx 臨時執行（免全域安裝 fec）
 
 ```bash
-# 安裝到目前專案
-npx frontend-craft@latest install --local claude
-
-# 全域安裝到某個執行時
-npx frontend-craft@latest install --global codex
-
-# 預覽所有執行時的安裝內容（不實際寫入）
-npx frontend-craft@latest install --all --dry-run --global
-
-# 列出支援的執行時
-npx frontend-craft@latest list
+# 1. 互動精靈
+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
+
+# 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
+
+# 4. 預覽 / 查詢
+npx @bovinphang/frontend-craft@latest install --all --dry-run --global
+npx @bovinphang/frontend-craft@latest list
 ```
 
-> **CI / 腳本場景：** 務必帶上 `--global` / `-g` 或 `--local` / `-l`。非 TTY 且未指定時，CLI 預設安裝到 `claude --global`。
+不想全域安裝 `fec` 指令時使用 `npx`。不帶參數會進入互動精靈：先選擇一個或多個執行時，再決定接入全域還是目前專案。腳本化安裝全部 runtime 時使用 `install --all --local` 或 `install --all --global`，不要寫成 `install all`。CI / 腳本場景請務必帶上 `--global` / `-g` 或 `--local` / `-l`；非 TTY 且未指定時，CLI 預設安裝到 `claude --global`。
 
-### 方式四：Claude Code Marketplace
+### 方式三：Claude Code Marketplace
 
 對 Claude Code 用戶，**Claude Code Marketplace** 是推薦的單一來源安裝方式。只有在需要跨執行時安裝、腳本化/離線複製檔案，或非 Marketplace 環境時，才建議對 Claude 使用 CLI。
 
@@ -133,7 +147,7 @@ npx frontend-craft@latest list
 ```text
 你：「合併前請審查我最近的改動。重點看架構、型別安全、渲染行為、樣式、可存取性和缺失測試。」
 你：「先不要寫程式碼，請規劃帳號帳單功能：路由結構、元件邊界、資料流、狀態歸屬、驗證流程和上線風險。」
-你：「請用 React Hook Form + Zod 建構多步註冊表單，包含檔案上傳、條件欄位、非同步驗證和可存取錯誤提示。」
+你：「請建構多步註冊表單：依專案框架選擇表單與 schema 驗證方案，包含檔案上傳、條件欄位、非同步驗證和可存取錯誤提示。」
 你：「請按 Figma 節點 123:456 實作 UI。複用現有 design token 和元件，匹配間距與響應式狀態，並說明假設。」
 你：「`/fec-refactor-clean` 請清理這個模組裡的死程式碼。」
 ```
@@ -155,13 +169,13 @@ npx frontend-craft@latest list
 | `/fec-tdd`            | 紅 → 綠 → 重構的前端 TDD 循環                               | —                                                |
 | `/fec-debug`          | 前端問題診斷與修復：建置失敗、執行時錯誤、UI 異常、介面問題 | `debug-*.md`                                     |
 | `/fec-refactor-clean` | 分類並安全清理死程式碼、未使用匯出、樣式和依賴              | `refactor-clean-*.md`                            |
-| `/fec-doc-sync`       | 同步 README、runtime 文件、能力表和公開 metadata            | —                                                |
+| `/fec-doc-sync`       | 同步 README、docs、環境變數、腳本、API/路由說明和部署文件 | —                                                |
 
 ### 技能（Skills，自動啟用）
 
 技能是根據檔案模式、框架或任務上下文**自動啟用**的工作流定義，編碼了審查維度、輸出約定和報告格式。
 
-下方按使用場景分組列出全部自動啟用的技能，便於快速找到專案規範、實作、測試、審查、設計、遷移和文件維護能力。
+下方按使用場景分組列出全部自動啟用的技能，便於快速找到專案規範、實作、測試、審查、設計、遷移、專案演進和文件維護能力。
 
 **專案規範** — 偵測到對應框架時自動生效：
 
@@ -178,17 +192,17 @@ npx frontend-craft@latest list
 
 | 技能                      | 範圍                                                       |
 | ------------------------- | ---------------------------------------------------------- |
-| `fec-data-fetching`       | TanStack Query / 服務端狀態獲取、快取、樂觀更新            |
+| `fec-data-fetching`       | 服務端狀態獲取、快取、失效、SSR、無限載入                  |
 | `fec-api-integration`     | 型別化 API client、鑑權刷新、上傳、即時整合                |
 | `fec-state-management`    | 狀態歸屬、store 選型、URL 狀態、伺服器/表單/本地狀態邊界   |
-| `fec-form-handling`       | React Hook Form + Zod、動態欄位、上傳、多步流程            |
+| `fec-form-handling`       | 跨框架表單選型、schema 驗證、動態欄位、上傳                 |
 | `fec-browser-storage`     | localStorage / sessionStorage / IndexedDB / Cookies 選型   |
 | `fec-route-protection`    | React Router、Next.js、Vue Router、Nuxt 的登入態與權限路由 |
 | `fec-pwa-implementation`  | manifest、Service Worker、離線快取、安裝提示               |
 | `fec-web-workers`         | Web Worker、Transferable、Comlink、Worker 池               |
 | `fec-canvas-threejs`      | Canvas 2D、Three.js、React Three Fiber、WebGL              |
 | `fec-svg-animation`       | CSS / Framer Motion / GSAP SVG 動畫與 reduced-motion       |
-| `fec-list-virtualization` | react-window / TanStack Virtual 大清單虛擬滾動             |
+| `fec-list-virtualization` | 依框架選型的大清單虛擬滾動、測量、網格和無限滾動            |
 
 **測試** — 規劃或撰寫前端測試覆蓋時啟用：
 
@@ -204,6 +218,7 @@ npx frontend-craft@latest list
 | 技能                           | 範圍                                                    |
 | ------------------------------ | ------------------------------------------------------- |
 | `fec-code-review`              | 架構、型別、渲染、樣式、可存取性審查                    |
+| `fec-debug-framework`          | 系統化診斷建置、執行時、UI 和 API/資料問題              |
 | `fec-typescript-type-safety`   | 型別契約、DTO 對映、型別守衛、泛型和型別級檢查          |
 | `fec-security-review`          | XSS、CSRF、敏感資料外洩、輸入驗證                       |
 | `fec-accessibility-check`      | WCAG 2.2、鍵盤、焦點、觸控和螢幕閱讀器行為              |
@@ -228,13 +243,19 @@ npx frontend-craft@latest list
 | 技能                             | 範圍                                           |
 | -------------------------------- | ---------------------------------------------- |
 | `fec-legacy-web-standard`        | JS + jQuery + HTML 傳統專案的開發與維護規範    |
-| `fec-legacy-to-modern-migration` | jQuery/MPA → React/Vue 3 + TS 策略與分階段流程 |
+| `fec-legacy-to-modern-migration` | 遺留前端現代化、目標技術棧識別與分階段遷移流程 |
+
+**專案演進** — 吸收參考系統並原創化落到目前專案時啟用：
+
+| 技能          | 範圍                                       |
+| ------------- | ------------------------------------------ |
+| `fec-alchemy` | 將參考系統能力原創化吸收到目前專案原生體系 |
 
 **文件維護** — 文件維護時啟用：
 
 | 技能                            | 範圍                                       |
 | ------------------------------- | ------------------------------------------ |
-| `fec-doc-sync`                  | 讓公開文件與腳本、技能、代理、指令保持同步 |
+| `fec-doc-sync`                  | 讓前端文件與程式碼、設定、腳本、路由、API、環境變數和部署事實保持同步 |
 | `fec-source-driven-development` | 以專案事實和官方來源驗證版本敏感的前端決策 |
 
 ### 代理（Agents）
@@ -365,11 +386,12 @@ $env:MODAO_TOKEN = "your-modao-token"
 每一次審查、分析和評估都會輸出帶時間戳記的 Markdown 報告到 `reports/`，可作為稽核記錄和 PR 交付物。
 
 <details>
-<summary>查看全部 15 種報告類型</summary>
+<summary>查看全部 16 種報告類型</summary>
 
 | 報告類型       | 檔名模式                                     | 來源                                                                |
 | -------------- | -------------------------------------------- | ------------------------------------------------------------------- |
 | 程式碼審查     | `code-review-YYYY-MM-DD-HHmmss.md`           | `/fec-review`、`fec-code-review`、`fec-code-reviewer`               |
+| 除錯診斷       | `debug-YYYY-MM-DD-HHmmss.md`                 | `/fec-debug`、`fec-debug-framework`、`fec-debugger`                 |
 | TS/JS 專項審查 | `typescript-review-YYYY-MM-DD-HHmmss.md`     | `fec-typescript-reviewer`                                           |
 | 安全審查       | `security-review-YYYY-MM-DD-HHmmss.md`       | `fec-security-review`、`fec-security-reviewer`                      |
 | 無障礙檢查     | `accessibility-review-YYYY-MM-DD-HHmmss.md`  | `fec-accessibility-check`                                           |
@@ -393,7 +415,7 @@ $env:MODAO_TOKEN = "your-modao-token"
 
 ## 更新與移除
 
-`fec` 是 `frontend-craft` 的短命令。如果沒有全域安裝 `fec`，可以把同樣參數接在 `npx frontend-craft@latest` 後使用，例如 `npx frontend-craft@latest update`。
+`fec` 是 `frontend-craft` 的短命令。如果沒有全域安裝 `fec`，可以把同樣參數接在 `npx @bovinphang/frontend-craft@latest` 後使用，例如 `npx @bovinphang/frontend-craft@latest update`。
 
 ### 更新
 
@@ -437,7 +459,7 @@ npx skills check                           # 預覽可用更新
 
 | CLI                  | 安裝內容                                      |
 | -------------------- | --------------------------------------------- |
-| `npx frontend-craft` | 技能 + 執行時專屬代理、指令、鉤子、規則、範本 |
+| `npx @bovinphang/frontend-craft` | 技能 + 執行時專屬代理、指令、鉤子、規則、範本 |
 | `npx skills`         | 僅技能（適用於已有 Skills CLI 工作流）        |
 
 關閉遙測：`DISABLE_TELEMETRY=1`。詳見 [skills.sh CLI 文件](https://skills.sh/docs/cli)。

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
     "id": "frontend-craft",
     "name": "Frontend Craft",
     "description": "Frontend team skills, OpenClaw workspace templates, optional init tool, exec safety hooks, and design MCP reference.",
-    "version": "2.5.0",
+    "version": "2.6.0",
     "skills": [
         "skills",
         "commands"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bovinphang/frontend-craft",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "Universal frontend plugin for Claude Code, Codex, Cursor, OpenCode, Gemini CLI, Qoder, Windsurf, Copilot, OpenClaw, and more — skills, agents, commands, hooks, and MCP templates.",
   "type": "module",
   "license": "MIT",

package/skills/eval_queries.json

@@ -21,6 +21,31 @@
       "把 jQuery 项目迁移到 Vue"
     ]
   },
+  "fec-alchemy": {
+    "should_trigger": [
+      "分析这个参考仓库，把有价值的能力原创化吸收到当前项目",
+      "对比这个插件和我们的项目，提炼可以融合的架构思路",
+      "不要复制代码，帮我借鉴另一个项目的 commands 和 hooks",
+      "把这个开源项目的工作流改造成适合 frontend-craft 的 skill",
+      "研究相似产品的实现方式，并给当前仓库制定吸收计划",
+      "将参考项目里的优秀工程实践迁移成我们自己的方案",
+      "做一次项目吸收分析，区分可借鉴能力和不该引入的部分",
+      "originally absorb ideas from a reference repo into this project",
+      "参考后端项目的鉴权和可观测性设计，提炼适合当前服务的吸收方案",
+      "把另一个 CLI 工具的配置和错误输出体验原创化改造成我们的方案",
+      "对比这个库项目的公开 API 和版本策略，判断哪些能力适合吸收"
+    ],
+    "should_not_trigger": [
+      "修复这个组件的 TypeScript 类型错误",
+      "给 Button 写 React Testing Library 单测",
+      "只同步 README 里的 skill 数量",
+      "审查 dangerouslySetInnerHTML 的 XSS 风险",
+      "把 Vite 从 5 升级到 6",
+      "优化虚拟列表滚动卡顿",
+      "按 Figma 设计稿实现页面",
+      "配置 PWA manifest 和 Service Worker"
+    ]
+  },
   "fec-api-integration": {
     "should_trigger": [
       "设计前端 typed API client",

package/skills/fec-accessibility-check/SKILL.md

@@ -20,7 +20,7 @@ description: Use when reviewing or improving frontend accessibility, semantic st
 7. 复核 WCAG 2.2 新增高频风险：可见焦点不被遮挡、拖拽操作有替代路径、目标尺寸过小、帮助入口和认证流程不依赖记忆负担。
 8. 输出分级报告；报告格式见 [references/report-template.md](references/report-template.md)。
 
-## Detailed References
+## 详细参考
 
 撰写无障碍审查报告时，加载 [references/report-template.md](references/report-template.md)。需要验证屏幕阅读器公告、焦点读法和动态区域时，加载 [references/screen-reader-testing.md](references/screen-reader-testing.md)。
 

package/skills/fec-alchemy/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: fec-alchemy
+description: Use when absorbing ideas, capabilities, workflows, architecture, quality systems, ecosystem extensions, or engineering practices from any reference system into the current project through original, project-native redesign rather than copying.
+---
+
+# 项目吸收与原创化融合
+
+## Purpose
+
+将一个或多个参考系统中的优秀思想、能力和工程实践，转化为当前项目中原创、可维护、符合目标项目风格的改进。
+
+适用于吸收、借鉴、对标、迁移或融合另一个代码库、产品、框架、库、服务、CLI、插件、文档体系、AI/Agent 工具链、架构或工程工作流。普通 Bug 修复、单独 API 使用问题或直接文件格式转换不应使用本 Skill，除非用户明确要求项目级吸收或适配。
+
+## Procedure
+
+1. 明确目标和参考系统：
+   - 将当前仓库视为目标系统，它的架构、命名、测试、发布模型和维护边界是事实来源。
+   - 将外部仓库、上传压缩包、文档、示例、产品描述或运行体验视为参考系统，它们只提供证据和启发。
+   - 识别吸收范围：产品能力、架构模式、领域模型、接口协议、数据流、运行时行为、开发体验、质量体系、交付流程、文档知识或生态扩展。
+   - 信息较多时可使用 [assets/intake-template.md](assets/intake-template.md) 建立简要清单。
+2. 建立目标项目基线：
+   - 先读取目标项目 README、包元数据、目录结构、配置、现有入口、扩展点、测试命令和发布说明。
+   - 找出目标项目已有类似能力，判断应增强、合并、替换、拆分、文档化还是新增。
+3. 扫描参考项目：
+   - 优先查看 README、包元数据、源码布局、项目形态相关目录、关键模块、测试、示例和发布说明。
+   - 将观察记录为能力、意图、模式和取舍，不记录为要复制的文件清单。
+4. 提炼候选能力：
+   - 对每个候选项说明它解决的问题、用户价值、适配度、依赖、风险、可验证性和与目标项目现状的关系。
+   - 对许可证、来源不清楚或实现高度绑定参考项目的候选项，只提炼思想，不复用表达。
+5. 映射到目标架构：
+   - 使用目标项目原生命名、模块边界、依赖策略、编码约定和测试方式重新设计。
+   - 避免创建与现有模块竞争的并行系统；避免因为参考项目用了某依赖就盲目引入依赖。
+   - 非平凡变更可使用 [assets/absorption-plan-template.md](assets/absorption-plan-template.md)。
+6. 原创化实现或计划：
+   - 编写新代码或新文档，不复制参考项目中的非平凡代码、提示词、配置或文档表达。
+   - 吸收生态扩展、提示词、命令、插件、自动化、Agent 或规则时，统一职责边界并删除重复指令。
+   - 大型任务先交付垂直薄切片，并记录被拒绝或延期的候选项。
+7. 验证和汇报：
+   - 运行最相关的类型检查、Lint、测试、构建、文档校验或 Skill 校验。
+   - 如果无法验证，明确说明阻塞原因、风险范围和需要用户确认的信息。
+   - 必要时使用 [assets/review-checklist.md](assets/review-checklist.md) 做人工复核。
+
+## Constraints
+
+- 不把吸收任务变成机械化 diff 合并。
+- 不整体照搬参考项目的命名体系、文件结构或实现细节。
+- 不在许可证或用户意图不明确时逐字复用参考项目中的非平凡代码、文档、提示词或配置。
+- 不为了匹配参考项目而削弱安全、隐私、权限边界、测试、可维护性或目标项目产品方向。
+- 不声称原创化，除非输出能解释目标设计为何不同、为何适配目标项目、如何验证。
+- 不把长篇参考材料塞进主说明；大型任务读取 [references/methodology.md](references/methodology.md)，许可证和原创风险读取 [references/originality-and-licensing.md](references/originality-and-licensing.md)。
+
+## Expected Output
+
+分析类任务输出：
+
+- 吸收候选项
+- 推荐目标设计
+- 实现计划
+- 风险与许可证说明
+- 验证清单
+
+实现类任务输出：
+
+- 已完成变更
+- 原创化说明
+- 验证结果
+- 剩余工作
+
+仓库级任务中，如果宿主工具支持文件编辑，应创建或更新项目本地计划文档。
+
+## 详细参考
+
+- [references/methodology.md](references/methodology.md) - 详细吸收方法论。
+- [references/originality-and-licensing.md](references/originality-and-licensing.md) - 原创性、许可证和来源风险约束。