@bovinphang/frontend-craft 2.8.0 → 2.9.0

package/README.openclaw.zh-CN.md

@@ -1,320 +1,359 @@
-# frontend-craft
-
-[![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)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript&logoColor=white)
-![Node](https://img.shields.io/badge/-Node.js-339933?logo=node.js&logoColor=white)
-
----
-
-<div align="center">
-
-**Language / 语言**
-
-[English](README.openclaw.md) | [**简体中文**](README.openclaw.zh-CN.md)
-
-</div>
-
----
-
-**面向 OpenClaw 的 frontend-craft 原生插件包。**
-
-`frontend-craft` 是 [frontend-craft](https://github.com/bovinphang/frontend-craft) 的 OpenClaw 原生打包产物，包含工作流技能、Markdown 命令、OpenClaw 工作区模板、typed hooks、设计工具 MCP 参考配置，以及可选的 `frontend_craft_init_workspace` 初始化工具。
-
-**环境要求：** Node.js **>= 22**，OpenClaw plugin API **>= 2026.4.20**。
-
----
-
-## 快速开始
-
-### 1. 安装
-
-从 ClawHub 安装（发布后推荐）：
-
-```bash
-openclaw plugins install clawhub:frontend-craft
-```
-
-从 npm 安装：
-
-```bash
-openclaw plugins install frontend-craft
-```
-
-从主仓库构建出的本地 tarball 安装：
-
-```bash
-npm install
-npm run pack:openclaw
-openclaw plugins install ./frontend-craft-<version>.tgz
-```
-
-本地开发时可链接包目录：
-
-```bash
-openclaw plugins install -l /path/to/frontend-craft/npm-packages/openclaw
-```
-
-### 2. 启用插件
-
-npm 包名和 OpenClaw 插件 id 均为 `frontend-craft`。
-
-```json5
-{
-  plugins: {
-    allow: ["frontend-craft"],
-    entries: {
-      "frontend-craft": {
-        enabled: true,
-        config: {
-          // 可选，字段见 openclaw.plugin.json：
-          // formatAfterWrite: true,
-          // notifyOnAgentEnd: true,
-        },
-      },
-    },
-  },
-}
-```
-
-调整插件配置后重启网关：
-
-```bash
-openclaw gateway restart
-openclaw plugins inspect frontend-craft
-```
-
-### 3. 初始化 OpenClaw 工作区
-
-OpenClaw 通常从代理工作区加载上下文，例如 `~/.openclaw/workspace`。可使用可选工具 `frontend_craft_init_workspace`，参数为：
-
-- `workspaceDir`：工作区根目录的绝对路径
-- `overwriteAgents`：仅在需要覆盖已有 `AGENTS.md` 时设为 `true`
-
-该工具会复制：
-
-- `templates/openclaw/AGENTS.md` -> 工作区 `AGENTS.md`
-- `templates/shared/rules/*.md` -> 工作区 `skills/frontend-craft-rules/`
-
-你也可以手工复制这些文件。OpenClaw 配置说明见 `templates/openclaw/OPENCLAW-CONFIG.md`。
-
-### 4. 配置设计工具 MCP
-
-包内 `.mcp.json` 是 Figma、Sketch、MasterGo、Pixso、墨刀的参考配置。OpenClaw 原生插件不会自动合并 MCP 配置，请将其中的 `mcpServers` 拷贝到 embedded Pi / 网关 MCP 配置中。
-
-常见环境变量：
-
-| 变量             | 工具            |
-| ---------------- | --------------- |
-| `FIGMA_API_KEY`  | Figma / Desktop |
-| `SKETCH_API_KEY` | Sketch          |
-| `MG_MCP_TOKEN`   | MasterGo        |
-| `MODAO_TOKEN`    | 墨刀            |
-
-Pixso 使用 `.mcp.json` 中的本地 MCP URL。摹客暂无 MCP 集成，请使用截图或导出标注。
-
----
-
-## 包结构
-
-```text
-frontend-craft/
-|-- dist/                  # 打包后的 OpenClaw 插件入口
-|-- skills/                # 工作流技能
-|-- commands/              # 作为技能加载的 Markdown 命令说明
-|-- templates/openclaw/    # OpenClaw AGENTS.md 与配置说明
-|-- templates/shared/      # 共享前端规则
-|-- .mcp.json              # 设计工具 MCP 参考配置
-|-- openclaw.plugin.json   # 插件元数据与配置 schema
-|-- package.json
-```
-
----
-
-## 功能概览
-
-### 技能
-
-OpenClaw 包包含 `skills/` 下全部 45 个公开工作流技能，按使用场景分组如下。
-
-**项目规范**
-
-| 技能                             | 用途                                                |
-| -------------------------------- | --------------------------------------------------- |
-| `fec-react-project-standard`     | React + TypeScript 项目规范                         |
-| `fec-vue3-project-standard`      | Vue 3 + TypeScript 项目规范                         |
-| `fec-nextjs-project-standard`    | Next.js App Router、SSR/SSG、路由、元数据、中间件   |
-| `fec-nuxt-project-standard`      | Nuxt 3 SSR/SSG、组合式函数、路由、中间件            |
-| `fec-vite-project-standard`      | Vite 配置、环境变量安全、HMR、开发代理、构建优化    |
-| `fec-monorepo-project-standard`  | pnpm workspace、Turborepo、Nx 结构与任务编排        |
-| `fec-typescript-project-standard` | TypeScript 配置、公开类型、声明文件、DTO 和泛型     |
-
-**实现能力**
-
-| 技能                      | 用途                                                           |
-| ------------------------- | -------------------------------------------------------------- |
-| `fec-data-fetching`       | 服务端状态获取、缓存、失效、SSR 与无限加载                     |
-| `fec-api-integration`     | 类型化 API 客户端、鉴权刷新、上传与实时通信                    |
-| `fec-state-management`    | 状态归属、store 选型、URL/服务端/表单/本地状态边界             |
-| `fec-form-handling`       | 跨框架表单选型、schema 校验、动态字段、上传、多步流程          |
-| `fec-browser-storage`     | localStorage/sessionStorage/IndexedDB/Cookies 选型与安全持久化 |
-| `fec-route-protection`    | React Router、Next.js、Vue Router、Nuxt 的权限路由保护         |
-| `fec-pwa-implementation`  | PWA 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` | 按框架选型的大列表虚拟滚动、测量、网格和无限滚动               |
-
-**测试**
-
-| 技能                    | 用途                                                     |
-| ----------------------- | -------------------------------------------------------- |
-| `fec-testing-strategy`  | 测试层级选择、风险矩阵与覆盖规划                         |
-| `fec-component-testing` | RTL / Vue Test Utils 组件测试与回归用例                  |
-| `fec-e2e-testing`       | Playwright / Cypress E2E 结构、产物、CI 与不稳定用例治理 |
-| `fec-tdd-workflow`      | 测试先行的 red-green-refactor 前端实现流程               |
-
-**评审与质量**
-
-| 技能                           | 用途                                                     |
-| ------------------------------ | -------------------------------------------------------- |
-| `fec-code-review`              | 架构、类型安全、渲染、样式、可访问性、测试、安全评审     |
-| `fec-debug-framework`          | 构建、运行时、UI 与 API/data 问题的系统化诊断            |
-| `fec-security-review`          | XSS、CSRF、敏感数据泄露、不安全输入处理                  |
-| `fec-accessibility-check`      | 面向 WCAG 的语义结构、键盘支持、焦点、标签检查           |
-| `fec-dependency-upgrade`       | 依赖升级、lockfile 评审、CVE 修复和迁移验证              |
-| `fec-validation-fix`           | 执行校验命令、分析失败并安全修复                         |
-| `fec-performance-optimization` | Core Web Vitals、bundle、渲染、内存、网络和预算评审      |
-| `fec-refactor-clean`           | 安全清理死代码、未用导出、样式、路由与依赖               |
-
-**设计 UI**
-
-| 技能                          | 用途                                                       |
-| ----------------------------- | ---------------------------------------------------------- |
-| `fec-ui-design`               | UI 方向、视觉识别、界面打磨、状态与视觉 QA                 |
-| `fec-image-generation`        | 图表、图片生成/编辑、视觉资产与 PNG QA 修复循环            |
-| `fec-drawio-studio`           | 可编辑 draw.io / diagrams.net 技术图、形状检索与代码结构图 |
-| `fec-web-video-presentation`  | 将文章、口播稿、课程和 demo 转成可录屏的 16:9 步进网页演示 |
-| `fec-tailwind-design-system`  | Tailwind token、主题扩展、组件变体、class 治理和暗色模式   |
-| `fec-responsive-layout`       | 移动优先布局、容器查询、数据密集型响应式界面               |
-| `fec-motion-interaction`      | 上下文感知动效、页面转场、滚动动画与 reduced motion        |
-| `fec-implement-from-design`   | 基于 Figma、Sketch、MasterGo、Pixso、墨刀或截图实现 UI     |
-| `fec-storybook-component-doc` | Storybook 组件文档、设计系统展示与隔离状态预览             |
-
-**遗留迁移**
-
-| 技能                             | 用途                                       |
-| -------------------------------- | ------------------------------------------ |
-| `fec-legacy-web-standard`        | JavaScript + jQuery + HTML/CSS 传统前端规范 |
-| `fec-legacy-to-modern-migration` | 遗留前端现代化、目标栈识别与分阶段迁移策略 |
-
-**项目演进**
-
-| 技能          | 用途                                             |
-| ------------- | ------------------------------------------------ |
-| `fec-alchemy` | 吸收参考系统想法，并重设计为原创、项目原生改进   |
-
-**维护与文档**
-
-| 技能                            | 用途                                                     |
-| ------------------------------- | -------------------------------------------------------- |
-| `fec-backend-requirements-handoff` | 面向后端交接 UI 数据需求、用户动作、状态、规则和问题   |
-| `fec-doc-sync`                  | 同步 README、配置、脚本、路由/API、环境变量与部署事实   |
-| `fec-source-driven-development` | 根据项目事实和官方来源校验版本敏感的前端决策             |
-
-### 技能使用：场景与示例
-
-技能定义在 `skills/<id>/SKILL.md`。本插件在 `openclaw.plugin.json` 中将 `skills` 与 `commands` 注册为技能根。运行时一般会按各技能前置元数据里的 **description** 与当前任务做 **自动匹配**；具体行为取决于你的 OpenClaw / Agent 配置。**普通用户不必知道内部技能 id**，用自然语言说明目标即可；熟悉仓库的人若知道 id 也可以显式写出。
-
-本节是面向 OpenClaw 的快速示例，不是完整提示词清单。完整的按场景组织的提示词库覆盖 skills、agents、commands、设计工作流、测试、维护和 runtime 初始化，见 [docs/zh-CN/example-prompts.md](docs/zh-CN/example-prompts.md)。
-
-**使用建议**
-
-- 评审或重构时尽量带上 **文件路径、目录或组件名**。
-- 设计还原请提供 **Figma 链接 / 节点 id、截图**，或说明已配置的设计 MCP。
-- lint、类型检查、测试或构建失败时，请写明你实际执行的 **命令**（若与常见脚本不一致）。
-
-**OpenClaw 快速场景与示例话术**
-
-| 场景                         | 技能（供查阅）                   | 示例话术（不出现技能名）                                                                                                               |
-| ---------------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| 合并前做 PR / 分支评审       | `fec-code-review`                | 「合并前请评审 `src/features/checkout/`：架构、类型、无障碍和测试；把 Markdown 报告写到 `reports/`。」                                 |
-| 聚焦 XSS、密钥、危险 DOM     | `fec-security-review`            | 「请审计 `src/lib/auth.ts` 以及所有渲染或存储用户 HTML 的代码，按严重程度列出 XSS 与密钥泄露风险及修复建议。」                         |
-| 新弹窗 / 表单 — 键盘与 ARIA  | `fec-accessibility-check`        | 「检查 `src/components/ConfirmDialog.tsx` 的键盘陷阱、焦点顺序、标签与 ARIA，并给出可落地的修改建议。」                                |
-| 对齐 React 工程约定          | `fec-react-project-standard`     | 「我们使用 React 18 和 TanStack Query，请对照成熟 React + TS 实践评审 `src/pages/Dashboard/`，并贴合现有抽象。」                       |
-| 对齐 Vue 工程约定            | `fec-vue3-project-standard`      | 「请评审 `src/views/Settings.vue` 及相关 composables，是否符合 Vue 3 + TS 惯例并与项目其余部分一致。」                                 |
-| 按设计稿 / 截图实现 UI       | `fec-implement-from-design`      | 「请按 Figma 节点 `123:456` 实现该界面：间距与设计 Token 对齐，复用现有 `Button`，并说明假设条件。」                                   |
-| CI 或本地脚本失败            | `fec-validation-fix`             | 「`pnpm lint` 和 `pnpm test` 都挂了，请定位根因并修复，不要放宽类型或跳过检查。」                                                      |
-| 维护 jQuery / MPA 老页面     | `fec-legacy-web-standard`        | 「`public/js/legacy/*.js` 仍在生产使用，请在保持行为的前提下给出可维护性改进与模式建议。」                                             |
-| 规划遗留前端现代化         | `fec-legacy-to-modern-migration` | 「我们有 `static/app.js` 的 jQuery + 多页应用，请评估保留 MPA、局部现代化或迁到目标栈的分阶段方案、风险与里程碑。」                  |
-| 规划前端测试覆盖             | `fec-testing-strategy`           | 「这次 checkout 重构先别急着写测试，请把风险映射到静态检查、单元/组件、E2E、视觉、无障碍和安全覆盖。」                                 |
-| 补充或稳定 E2E               | `fec-e2e-testing`                | 「请用 Playwright 给登录流程加冒烟用例：目录清晰、使用 Page Object，并说明如何在 CI 里跑。」                                           |
-| Next.js App Router 功能      | `fec-nextjs-project-standard`    | 「请评审 `app/(dashboard)/reports/page.tsx` 及相关 server actions 是否符合 Next.js App Router 最佳实践（数据获取、错误、元数据等）。」 |
-| Nuxt 3 页面或布局            | `fec-nuxt-project-standard`      | 「请评审 `pages/admin/*.vue` 与 `composables/useApi.ts` 是否符合 Nuxt 3 的 SSR、数据与组合式用法惯例。」                               |
-| Monorepo 边界与任务编排      | `fec-monorepo-project-standard`  | 「`apps/web` 依赖 `packages/ui`，请检查包边界、workspace 配置和 Turborepo 任务图是否有问题。」                                         |
-| 服务端数据获取               | `fec-data-fetching`              | 「请评审 `src/data/reports.ts` 的服务端状态获取：缓存 key、失效策略、SSR 水合，以及是否需要查询库。」                                  |
-| 状态归属与 store 选型        | `fec-state-management`           | 「请审计 dashboard 的状态：哪些属于 URL 参数、TanStack Query、本地 state 或全局 store，并给出安全迁移方案。」                          |
-| 复杂表单与校验               | `fec-form-handling`              | 「构建多步注册表单：按项目框架选择表单库和 schema 校验方案，包含文件上传和动态条件字段。」                                             |
-| 为应用添加路由守卫           | `fec-route-protection`           | 「为 React Router 的 `/admin` 路由做权限保护：未登录用户重定向，基于角色控制访问。」                                                   |
-| 编写组件单元测试             | `fec-component-testing`          | 「为 `src/components/UserCard.tsx` 编写 RTL 测试：渲染、user-event 交互和快照回归用例。」                                              |
-| 组件库文档化                 | `fec-storybook-component-doc`    | 「为 `packages/ui/` 搭建 Storybook：MDX 文档、无障碍 addon 和交互测试。」                                                              |
-| 渲染上万条列表数据           | `fec-list-virtualization`        | 「`ProductList` 渲染上万行太卡，请按现有框架、动态高度、浏览器查找和 SEO 约束选择虚拟滚动方案并测量性能。」                            |
-| 添加离线支持                 | `fec-pwa-implementation`         | 「把这个 React 应用做成 PWA：manifest、Service Worker、离线缓存策略和安装提示。」                                                      |
-| 重计算移出主线程             | `fec-web-workers`                | 「把图片处理逻辑移到 Web Worker，用 Comlink 通信，保持 UI 响应。」                                                                     |
-| 构建交互式 3D 场景           | `fec-canvas-threejs`             | 「在 `src/components/ProductViewer.tsx` 添加 Three.js 产品展示，兼顾性能和降级方案。」                                                 |
-| 为落地页添加 SVG 动效        | `fec-svg-animation`              | 「用 Framer Motion 为 hero 区 SVG 添加动画，并为 reduced-motion 用户提供静态降级方案。」                                               |
-| 设计与打磨 UI                | `fec-ui-design`                  | 「请评审 `src/components/Dashboard.tsx` 的 UI 方向、视觉识别、间距、状态和动效打磨。」                                                 |
-| 构建可录屏网页演示           | `fec-web-video-presentation`     | 「把这段产品 demo 口播稿转成 16:9 浏览器演示：拆口播节拍、章节 step、主题 token，并给出录屏指引。」                                    |
-| 优化 Vite 构建配置           | `fec-vite-project-standard`      | 「请审计 `vite.config.ts` 的 HMR、开发代理、环境变量安全和库模式最佳实践。」                                                           |
-
-**斜杠命令（`commands/` 下的 Markdown）**
-
-作为**固定步骤**的命令说明加载。对话里用自然语言描述要做的事即可，代理可按对应命令文档执行，**无需**说出命令文件名。完整命令提示词见 [docs/zh-CN/example-prompts.md](docs/zh-CN/example-prompts.md#高级用户提示词)。
-
-| 命令文档                 | 适用时机                                                                                 | 示例（自然语言）                                                                                                  |
-| ------------------------ | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
-| `fec-init.md`            | 在**业务仓库**里初始化 **Claude 风格** 的 `.claude/` 模板（文档内路径针对 `.claude/`）。 | 「请在本仓库初始化 `.claude/`，按插件提供的模板与规则复制；若已有文件请先问我是否覆盖。」                         |
-| `fec-review.md`          | 引导式评审并保存 `reports/code-review-*.md`。                                            | 「请评审我上一次提交里改动的文件，并写一份结构化 Markdown 报告到 `reports/`。」                                   |
-| `fec-scaffold.md`        | 页面 / 功能 / 组件目录脚手架。                                                           | 「请为 React 项目脚手架一个新页面 UserDetail：放在 `src/pages/...`，并带上空的 `components/` 与 `hooks/` 目录。」 |
-| `fec-plan.md`            | 实现前做架构方案或测试策略规划。                                                         | 「先规划 checkout 重写：组件边界、状态流、风险和测试覆盖。」                                                      |
-| `fec-tdd.md`             | 使用 red-green-refactor 的测试驱动实现流程。                                             | 「这个筛选组件请按 TDD 做：先写失败测试，再实现最小行为。」                                                       |
-| `fec-debug.md`           | 诊断构建、运行时、UI 或 API/data 失败。                                                  | 「登录后 dashboard 崩溃，请检查错误路径、定位根因，并写一份 debug 报告。」                                        |
-| `fec-refactor-clean.md`  | 分类并安全清理死代码、未用导出、样式和依赖。                                             | 「清理 `src/features/billing/` 里的未用导出和样式，保持行为不变并报告变更。」                                     |
-| `fec-doc-sync.md`        | 同步 README、文档、环境说明、脚本列表、API/路由说明和部署事实。                          | 「检查 README 命令列表是否还匹配 package scripts，并更新漂移的文档。」                                            |
-
-### Hooks
-
-| Hook                  | 行为                                                                  |
-| --------------------- | --------------------------------------------------------------------- |
-| `before_tool_call`    | 拦截危险 shell / exec 类命令                                          |
-| `after_tool_call`     | 可选地对 write/edit 目标运行 Prettier（`formatAfterWrite`，默认开启） |
-| `before_prompt_build` | 每个会话追加一次框架与包管理器提示                                    |
-| `agent_end`           | 运行成功时输出完成提示音 / 日志行（`notifyOnAgentEnd`，默认开启）     |
-
-### 插件配置
-
-| 键                 | 类型    | 默认   | 含义                                    |
-| ------------------ | ------- | ------ | --------------------------------------- |
-| `formatAfterWrite` | boolean | `true` | write/edit 工具调用后运行 Prettier      |
-| `notifyOnAgentEnd` | boolean | `true` | agent 运行成功时输出完成提示音 / 日志行 |
-
----
-
-## 从源码构建
-
-在主 `frontend-craft` 仓库中执行：
-
-```bash
-npm install
-npm run typecheck:openclaw
-npm run pack:openclaw
-```
-
-`npm run pack:openclaw` 会构建并校验 OpenClaw bundle，刷新 `npm-packages/openclaw`，并在 `npm-packages/openclaw/` 目录下写出 `frontend-craft-<version>.tgz`。
-
----
-
-## License
-
-MIT
+# frontend-craft
+
+[![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)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript&logoColor=white)
+![Node](https://img.shields.io/badge/-Node.js-339933?logo=node.js&logoColor=white)
+
+---
+
+<div align="center">
+
+**Language / 语言**
+
+[English](README.openclaw.md) | [**简体中文**](README.openclaw.zh-CN.md)
+
+</div>
+
+---
+
+**面向 OpenClaw 的 frontend-craft 原生插件包。**
+
+`frontend-craft` 是 [frontend-craft](https://github.com/bovinphang/frontend-craft) 的 OpenClaw 原生打包产物，包含工作流技能、Markdown 命令、OpenClaw 工作区模板、typed hooks、设计工具 MCP 参考配置，以及可选的 `frontend_craft_init_workspace` 初始化工具。
+
+该原生包提供 **56 个工作流技能**，并将 **11 个命令工作流通过技能提供（同名工作流复用完整技能）**。14 个专业 Agent 属于其他运行时适配器，不是 OpenClaw 原生 Agent。
+
+**环境要求：** Node.js **>= 22**，OpenClaw plugin API **>= 2026.4.20**。
+
+---
+
+## 快速开始
+
+### 1. 安装
+
+从 ClawHub 安装（发布后推荐）：
+
+```bash
+openclaw plugins install clawhub:frontend-craft
+```
+
+从 npm 安装：
+
+```bash
+openclaw plugins install frontend-craft
+```
+
+从主仓库构建出的本地 tarball 安装：
+
+```bash
+npm install
+npm run pack:openclaw
+openclaw plugins install ./frontend-craft-<version>.tgz
+```
+
+本地开发时可链接包目录：
+
+```bash
+openclaw plugins install -l /path/to/frontend-craft/npm-packages/openclaw
+```
+
+### 2. 启用插件
+
+npm 包名和 OpenClaw 插件 id 均为 `frontend-craft`。
+
+```json5
+{
+  plugins: {
+    allow: ["frontend-craft"],
+    entries: {
+      "frontend-craft": {
+        enabled: true,
+        config: {
+          // 可选，字段见 openclaw.plugin.json：
+          // formatAfterWrite: true,
+          // notifyOnAgentEnd: true,
+        },
+      },
+    },
+  },
+}
+```
+
+调整插件配置后重启网关：
+
+```bash
+openclaw gateway restart
+openclaw plugins inspect frontend-craft
+```
+
+### 3. 初始化 OpenClaw 工作区
+
+OpenClaw 通常从代理工作区加载上下文，例如 `~/.openclaw/workspace`。可使用可选工具 `frontend_craft_init_workspace`，参数为：
+
+- `workspaceDir`：工作区根目录的绝对路径
+- `overwriteAgents`：仅在需要覆盖已有 `AGENTS.md` 时设为 `true`
+
+该工具会复制：
+
+- `templates/openclaw/AGENTS.md` -> 工作区 `AGENTS.md`
+- `templates/shared/rules/*.md` -> 工作区 `skills/frontend-craft-rules/`
+
+你也可以手工复制这些文件。OpenClaw 配置说明见 `templates/openclaw/OPENCLAW-CONFIG.md`。
+
+### 4. 配置设计工具 MCP
+
+包内 `.mcp.json` 是 Figma、Sketch、MasterGo、Pixso、墨刀的参考配置。OpenClaw 原生插件不会自动合并 MCP 配置，请将其中的 `mcpServers` 拷贝到 embedded Pi / 网关 MCP 配置中。
+
+常见环境变量：
+
+| 变量             | 工具            |
+| ---------------- | --------------- |
+| `FIGMA_API_KEY`  | Figma / Desktop |
+| `SKETCH_API_KEY` | Sketch          |
+| `MG_MCP_TOKEN`   | MasterGo        |
+| `MODAO_TOKEN`    | 墨刀            |
+
+Pixso 使用 `.mcp.json` 中的本地 MCP URL。摹客暂无 MCP 集成，请使用截图或导出标注。
+
+---
+
+## 包结构
+
+```text
+frontend-craft/
+|-- dist/                  # 打包后的 OpenClaw 插件入口
+|-- skills/                # 工作流技能
+|-- commands/              # 命令源文件；转换后的技能位于 skills/
+|-- templates/openclaw/    # OpenClaw AGENTS.md 与配置说明
+|-- templates/shared/      # 共享前端规则
+|-- .mcp.json              # 设计工具 MCP 参考配置
+|-- openclaw.plugin.json   # 插件元数据与配置 schema
+|-- package.json
+```
+
+---
+
+## 功能概览
+
+### 技能
+
+OpenClaw 包包含 `skills/` 下全部 56 个公开工作流技能，按使用场景分组如下。
+
+**项目规范**
+
+| 技能                             | 用途                                                |
+| -------------------------------- | --------------------------------------------------- |
+| `fec-react-project-standard`     | React + TypeScript 项目规范                         |
+| `fec-vue3-project-standard`      | Vue 3 + TypeScript 项目规范                         |
+| `fec-nextjs-project-standard`    | Next.js App Router、SSR/SSG、路由、元数据、中间件   |
+| `fec-nuxt-project-standard`      | Nuxt 3 SSR/SSG、组合式函数、路由、中间件            |
+| `fec-vite-project-standard`      | Vite 配置、环境变量安全、HMR、开发代理、构建优化    |
+| `fec-monorepo-project-standard`  | pnpm workspace、Turborepo、Nx 结构与任务编排        |
+| `fec-typescript-project-standard` | TypeScript 配置、公开类型、声明文件、DTO 和泛型     |
+
+**实现能力**
+
+| 技能                      | 用途                                                           |
+| ------------------------- | -------------------------------------------------------------- |
+| `fec-data-fetching`       | 服务端状态获取、缓存、失效、SSR 与无限加载                     |
+| `fec-api-integration`     | 类型化 API 客户端、鉴权刷新、上传与实时通信                    |
+| `fec-state-management`    | 状态归属、store 选型、URL/服务端/表单/本地状态边界             |
+| `fec-form-handling`       | 跨框架表单选型、schema 校验、动态字段、上传、多步流程          |
+| `fec-browser-storage`     | localStorage/sessionStorage/IndexedDB/Cookies 选型与安全持久化 |
+| `fec-route-protection`    | React Router、Next.js、Vue Router、Nuxt 的权限路由保护         |
+| `fec-pwa-implementation`  | PWA 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` | 按框架选型的大列表虚拟滚动、测量、网格和无限滚动               |
+
+**测试**
+
+| 技能                    | 用途                                                     |
+| ----------------------- | -------------------------------------------------------- |
+| `fec-testing-strategy`  | 测试层级选择、风险矩阵与覆盖规划                         |
+| `fec-component-testing` | RTL / Vue Test Utils 组件测试与回归用例                  |
+| `fec-e2e-testing`       | Playwright / Cypress E2E 结构、产物、CI 与不稳定用例治理 |
+| `fec-tdd-workflow`      | 测试先行的 red-green-refactor 前端实现流程               |
+
+**评审与质量**
+
+| 技能                           | 用途                                                     |
+| ------------------------------ | -------------------------------------------------------- |
+| `fec-code-review`              | 架构、类型安全、渲染、样式、可访问性、测试、安全评审     |
+| `fec-debug-framework`          | 构建、运行时、UI 与 API/data 问题的系统化诊断            |
+| `fec-security-review`          | XSS、CSRF、敏感数据泄露、不安全输入处理                  |
+| `fec-accessibility-check`      | 面向 WCAG 的语义结构、键盘支持、焦点、标签检查           |
+| `fec-dependency-upgrade`       | 依赖升级、lockfile 评审、CVE 修复和迁移验证              |
+| `fec-validation-fix`           | 执行校验命令、分析失败并安全修复                         |
+| `fec-performance-optimization` | Core Web Vitals、bundle、渲染、内存、网络和预算评审      |
+| `fec-refactor-clean`           | 安全清理死代码、未用导出、样式、路由与依赖               |
+
+**重构**
+
+| 技能 | 用途 |
+| --- | --- |
+| `fec-refactoring` | 保持行为的重构编排与安全工作流 |
+| `fec-code-smells` | 基于证据诊断 24 种标准代码坏味道 |
+| `fec-refactoring-catalog` | 在 61 项标准手法中选择和组合 |
+| `fec-refactoring-functions` | 函数类重构 |
+| `fec-refactoring-encapsulation` | 封装类重构 |
+| `fec-refactoring-move-features` | 搬移特性类重构与清理路由 |
+| `fec-refactoring-data` | 数据重构 |
+| `fec-refactoring-control` | 条件/控制流重构 |
+| `fec-refactoring-api` | API 重构 |
+| `fec-refactoring-inheritance` | 继承/委托重构 |
+| `fec-refactoring-validation` | 行为保持验证与证明等级 |
+
+**设计 UI**
+
+| 技能                          | 用途                                                       |
+| ----------------------------- | ---------------------------------------------------------- |
+| `fec-ui-design`               | UI 方向、视觉识别、界面打磨、状态与视觉 QA                 |
+| `fec-image-generation`        | 图表、图片生成/编辑、视觉资产与 PNG QA 修复循环            |
+| `fec-drawio-studio`           | 可编辑 draw.io / diagrams.net 技术图、形状检索与代码结构图 |
+| `fec-web-video-presentation`  | 将文章、口播稿、课程和 demo 转成可录屏的 16:9 步进网页演示 |
+| `fec-tailwind-design-system`  | Tailwind token、主题扩展、组件变体、class 治理和暗色模式   |
+| `fec-responsive-layout`       | 移动优先布局、容器查询、数据密集型响应式界面               |
+| `fec-motion-interaction`      | 上下文感知动效、页面转场、滚动动画与 reduced motion        |
+| `fec-implement-from-design`   | 基于 Figma、Sketch、MasterGo、Pixso、墨刀或截图实现 UI     |
+| `fec-storybook-component-doc` | Storybook 组件文档、设计系统展示与隔离状态预览             |
+
+技术图质量工作流：`fec-image-generation` 的标准时序/流程图优先本地 Mermaid，架构图复用 draw.io 工作流，工具缺失时使用 JSON/HTML。导出 PNG 时生成实际测量且与缩放一致的 manifest，再运行 QA 并检查最终 PNG；保留完整文字、显式布局与关系，最多自动修复两轮，未解决问题需明确报告。可复现样例位于 `skills/fec-image-generation/assets/quality-examples/`。
+
+[审核范围与技术图交付指南](docs/zh-CN/review-and-diagram-workflows.md).
+
+**遗留迁移**
+
+| 技能                             | 用途                                       |
+| -------------------------------- | ------------------------------------------ |
+| `fec-legacy-web-standard`        | JavaScript + jQuery + HTML/CSS 传统前端规范 |
+| `fec-legacy-to-modern-migration` | 遗留前端现代化、目标栈识别与分阶段迁移策略 |
+
+**项目演进**
+
+| 技能          | 用途                                             |
+| ------------- | ------------------------------------------------ |
+| `fec-alchemy` | 吸收参考系统想法，并重设计为原创、项目原生改进   |
+
+**维护与文档**
+
+| 技能                            | 用途                                                     |
+| ------------------------------- | -------------------------------------------------------- |
+| `fec-backend-requirements-handoff` | 面向后端交接 UI 数据需求、用户动作、状态、规则和问题   |
+| `fec-doc-sync`                  | 同步 README、配置、脚本、路由/API、环境变量与部署事实   |
+| `fec-source-driven-development` | 根据项目事实和官方来源校验版本敏感的前端决策             |
+
+### 技能使用：场景与示例
+
+技能定义在 `skills/<id>/SKILL.md`。本插件在 `openclaw.plugin.json` 中将 `skills` 注册为技能根；命令工作流在打包时转换为技能。运行时一般会按各技能前置元数据里的 **description** 与当前任务做 **自动匹配**；具体行为取决于你的 OpenClaw / Agent 配置。**普通用户不必知道内部技能 id**，用自然语言说明目标即可；熟悉仓库的人若知道 id 也可以显式写出。
+
+本节是面向 OpenClaw 的快速示例，不是完整提示词清单。完整的按场景组织的提示词库覆盖 skills、agents、commands、设计工作流、测试、维护和 runtime 初始化，见 [docs/zh-CN/example-prompts.md](docs/zh-CN/example-prompts.md)。
+
+**使用建议**
+
+- 评审或重构时尽量带上 **文件路径、目录或组件名**。
+- 设计还原请提供 **Figma 链接 / 节点 id、截图**，或说明已配置的设计 MCP。
+- lint、类型检查、测试或构建失败时，请写明你实际执行的 **命令**（若与常见脚本不一致）。
+
+**OpenClaw 快速场景与示例话术**
+
+| 场景                         | 技能（供查阅）                   | 示例话术（不出现技能名）                                                                                                               |
+| ---------------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| 指定目录评审       | `fec-code-review`                | 「合并前请评审 `src/features/checkout/`：架构、类型、无障碍和测试；把 Markdown 报告写到 `reports/`。」                                 |
+| 聚焦 XSS、密钥、危险 DOM     | `fec-security-review`            | 「请审计 `src/lib/auth.ts` 以及所有渲染或存储用户 HTML 的代码，按严重程度列出 XSS 与密钥泄露风险及修复建议。」                         |
+| 新弹窗 / 表单 — 键盘与 ARIA  | `fec-accessibility-check`        | 「检查 `src/components/ConfirmDialog.tsx` 的键盘陷阱、焦点顺序、标签与 ARIA，并给出可落地的修改建议。」                                |
+| 对齐 React 工程约定          | `fec-react-project-standard`     | 「我们使用 React 18 和 TanStack Query，请对照成熟 React + TS 实践评审 `src/pages/Dashboard/`，并贴合现有抽象。」                       |
+| 对齐 Vue 工程约定            | `fec-vue3-project-standard`      | 「请评审 `src/views/Settings.vue` 及相关 composables，是否符合 Vue 3 + TS 惯例并与项目其余部分一致。」                                 |
+| 按设计稿 / 截图实现 UI       | `fec-implement-from-design`      | 「请按 Figma 节点 `123:456` 实现该界面：间距与设计 Token 对齐，复用现有 `Button`，并说明假设条件。」                                   |
+| CI 或本地脚本失败            | `fec-validation-fix`             | 「`pnpm lint` 和 `pnpm test` 都挂了，请定位根因并修复，不要放宽类型或跳过检查。」                                                      |
+| 维护 jQuery / MPA 老页面     | `fec-legacy-web-standard`        | 「`public/js/legacy/*.js` 仍在生产使用，请在保持行为的前提下给出可维护性改进与模式建议。」                                             |
+| 规划遗留前端现代化         | `fec-legacy-to-modern-migration` | 「我们有 `static/app.js` 的 jQuery + 多页应用，请评估保留 MPA、局部现代化或迁到目标栈的分阶段方案、风险与里程碑。」                  |
+| 规划前端测试覆盖             | `fec-testing-strategy`           | 「这次 checkout 重构先别急着写测试，请把风险映射到静态检查、单元/组件、E2E、视觉、无障碍和安全覆盖。」                                 |
+| 补充或稳定 E2E               | `fec-e2e-testing`                | 「请用 Playwright 给登录流程加冒烟用例：目录清晰、使用 Page Object，并说明如何在 CI 里跑。」                                           |
+| Next.js App Router 功能      | `fec-nextjs-project-standard`    | 「请评审 `app/(dashboard)/reports/page.tsx` 及相关 server actions 是否符合 Next.js App Router 最佳实践（数据获取、错误、元数据等）。」 |
+| Nuxt 3 页面或布局            | `fec-nuxt-project-standard`      | 「请评审 `pages/admin/*.vue` 与 `composables/useApi.ts` 是否符合 Nuxt 3 的 SSR、数据与组合式用法惯例。」                               |
+| Monorepo 边界与任务编排      | `fec-monorepo-project-standard`  | 「`apps/web` 依赖 `packages/ui`，请检查包边界、workspace 配置和 Turborepo 任务图是否有问题。」                                         |
+| 服务端数据获取               | `fec-data-fetching`              | 「请评审 `src/data/reports.ts` 的服务端状态获取：缓存 key、失效策略、SSR 水合，以及是否需要查询库。」                                  |
+| 状态归属与 store 选型        | `fec-state-management`           | 「请审计 dashboard 的状态：哪些属于 URL 参数、TanStack Query、本地 state 或全局 store，并给出安全迁移方案。」                          |
+| 复杂表单与校验               | `fec-form-handling`              | 「构建多步注册表单：按项目框架选择表单库和 schema 校验方案，包含文件上传和动态条件字段。」                                             |
+| 为应用添加路由守卫           | `fec-route-protection`           | 「为 React Router 的 `/admin` 路由做权限保护：未登录用户重定向，基于角色控制访问。」                                                   |
+| 编写组件单元测试             | `fec-component-testing`          | 「为 `src/components/UserCard.tsx` 编写 RTL 测试：渲染、user-event 交互和快照回归用例。」                                              |
+| 组件库文档化                 | `fec-storybook-component-doc`    | 「为 `packages/ui/` 搭建 Storybook：MDX 文档、无障碍 addon 和交互测试。」                                                              |
+| 渲染上万条列表数据           | `fec-list-virtualization`        | 「`ProductList` 渲染上万行太卡，请按现有框架、动态高度、浏览器查找和 SEO 约束选择虚拟滚动方案并测量性能。」                            |
+| 添加离线支持                 | `fec-pwa-implementation`         | 「把这个 React 应用做成 PWA：manifest、Service Worker、离线缓存策略和安装提示。」                                                      |
+| 重计算移出主线程             | `fec-web-workers`                | 「把图片处理逻辑移到 Web Worker，用 Comlink 通信，保持 UI 响应。」                                                                     |
+| 构建交互式 3D 场景           | `fec-canvas-threejs`             | 「在 `src/components/ProductViewer.tsx` 添加 Three.js 产品展示，兼顾性能和降级方案。」                                                 |
+| 为落地页添加 SVG 动效        | `fec-svg-animation`              | 「用 Framer Motion 为 hero 区 SVG 添加动画，并为 reduced-motion 用户提供静态降级方案。」                                               |
+| 设计与打磨 UI                | `fec-ui-design`                  | 「请评审 `src/components/Dashboard.tsx` 的 UI 方向、视觉识别、间距、状态和动效打磨。」                                                 |
+| 构建可录屏网页演示           | `fec-web-video-presentation`     | 「把这段产品 demo 口播稿转成 16:9 浏览器演示：拆口播节拍、章节 step、主题 token，并给出录屏指引。」                                    |
+| 优化 Vite 构建配置           | `fec-vite-project-standard`      | 「请审计 `vite.config.ts` 的 HMR、开发代理、环境变量安全和库模式最佳实践。」                                                           |
+
+**斜杠命令（`commands/` 下的 Markdown）**
+
+作为**固定步骤**的命令说明加载。对话里用自然语言描述要做的事即可，代理可按对应命令文档执行，**无需**说出命令文件名。完整命令提示词见 [docs/zh-CN/example-prompts.md](docs/zh-CN/example-prompts.md#高级用户提示词)。
+
+| 命令文档                 | 适用时机                                                                                 | 示例（自然语言）                                                                                                  |
+| ------------------------ | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `fec-init.md`            | 在**业务仓库**里初始化 **Claude 风格** 的 `.claude/` 模板（文档内路径针对 `.claude/`）。 | 「请在本仓库初始化 `.claude/`，按插件提供的模板与规则复制；若已有文件请先问我是否覆盖。」                         |
+| `fec-review.md`          | 引导式评审并保存 `reports/code-review-*.md`。                                            | 「请评审我上一次提交里改动的文件，并写一份结构化 Markdown 报告到 `reports/`。」                                   |
+| `fec-scaffold.md`        | 页面 / 功能 / 组件目录脚手架。                                                           | 「请为 React 项目脚手架一个新页面 UserDetail：放在 `src/pages/...`，并带上空的 `components/` 与 `hooks/` 目录。」 |
+| `fec-plan.md`            | 实现前做架构方案或测试策略规划。                                                         | 「先规划 checkout 重写：组件边界、状态流、风险和测试覆盖。」                                                      |
+| `fec-tdd.md`             | 使用 red-green-refactor 的测试驱动实现流程。                                             | 「这个筛选组件请按 TDD 做：先写失败测试，再实现最小行为。」                                                       |
+| `fec-debug.md`           | 诊断构建、运行时、UI 或 API/data 失败。                                                  | 「登录后 dashboard 崩溃，请检查错误路径、定位根因，并写一份 debug 报告。」                                        |
+| `fec-refactor-clean.md`  | 分类并安全清理死代码、未用导出、样式和依赖。                                             | 「清理 `src/features/billing/` 里的未用导出和样式，保持行为不变并报告变更。」                                     |
+| `fec-smell.md`         | 诊断结构代码坏味道，不修改业务代码。                                                     | 「找出 `Compose.tsx` 的代码坏味道并给出证据，先不要改。」                                                       |
+| `fec-refactor-plan.md` | 生成有顺序、保持行为的小步重构计划。                                                     | 「先为这个大型写信模块设计安全重构计划，不改代码。」                                                         |
+| `fec-refactor.md`      | 一次执行一个经过验证的保持行为重构步骤。                                                 | 「保持可观察行为不变地重构这个模块，并逐步验证。」                                                           |
+| `fec-doc-sync.md`        | 同步 README、文档、环境说明、脚本列表、API/路由说明和部署事实。                          | 「检查 README 命令列表是否还匹配 package scripts，并更新漂移的文档。」                                            |
+
+### Hooks
+
+| Hook                  | 行为                                                                  |
+| --------------------- | --------------------------------------------------------------------- |
+| `before_tool_call`    | 拦截危险 shell / exec 类命令                                          |
+| `after_tool_call`     | 可选地对 write/edit 目标运行 Prettier（`formatAfterWrite`，默认开启） |
+| `before_prompt_build` | 每个会话追加一次框架与包管理器提示                                    |
+| `agent_end`           | 运行成功时输出完成提示音 / 日志行（`notifyOnAgentEnd`，默认开启）     |
+
+### 插件配置
+
+| 键                 | 类型    | 默认   | 含义                                    |
+| ------------------ | ------- | ------ | --------------------------------------- |
+| `formatAfterWrite` | boolean | `true` | write/edit 工具调用后运行 Prettier      |
+| `notifyOnAgentEnd` | boolean | `true` | agent 运行成功时输出完成提示音 / 日志行 |
+
+---
+
+## 从源码构建
+
+在主 `frontend-craft` 仓库中执行：
+
+```bash
+npm install
+npm run typecheck:openclaw
+npm run pack:openclaw
+```
+
+`npm run pack:openclaw` 会构建并校验 OpenClaw bundle，刷新 `npm-packages/openclaw`，并在 `npm-packages/openclaw/` 目录下写出 `frontend-craft-<version>.tgz`。
+
+---
+
+## License
+
+MIT
+
+### 审核范围
+
+代码和安全审核 skill 采用三种模式。在 OpenClaw 中使用自然语言提出请求；以下斜杠命令示例适用于提供 `/fec-review` 的运行时：
+
+- **改动审核**：明确要求最近改动、本次修改、暂存区、PR 或提交，或当前任务已明确这些改动上下文。无改动时说明没有可审核的改动，不自动审核最近提交。
+- **指定范围审核**：指定文件或目录，审核其中现有代码，包括未改动代码，不要求 Git 差异。
+- **全项目审核（默认）**：未指定范围或改动上下文，或明确要求审核整个项目时，先建立项目自有前端代码、相关测试、配置和依赖声明清单，再按模块审核。
+
+指定文件或目录默认审核其全部代码；加上“本次改动”才仅审核差异。自然语言请求“审核代码”即使有改动也默认全项目；开始时说明模式和范围，修改后自动委托审核须显式传入本次改动范围。
+
+示例：`/fec-review`、`/fec-review 审核最近改动`、`/fec-review 审核 src/components/Button.tsx`、`/fec-review 审核 src/features/`、`/fec-review 审核整个项目`。这些是自然语言指令，不是 CLI 参数；明确指定的范围优先于默认模式。
+
+默认排除依赖目录、构建产物、缓存、生成文件和第三方代码。报告记录模式、目标范围、已审核及未覆盖文件或模块、排除项、完成状态和验证结果；覆盖不足时标记部分完成。读取调用方或执行全项目 lint/类型检查不等于完成人工审核。改动审核保留合并建议，指定范围和全项目审核评估已审核范围的风险。前端审核不替代后端专项审核；未要求修复时不修改业务代码。