@bovinphang/frontend-craft 2.5.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,61 @@
+{
+    "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+    "name": "frontend-craft",
+    "description": "Shared Claude Code plugin for frontend teams — agents, skills, hooks, and project templates for code review, design-to-code, architecture planning, security review, and UI debugging. All reports auto-saved as Markdown.",
+    "owner": {
+        "name": "Bovin Phang",
+        "email": "pengbaowen@msn.com"
+    },
+    "metadata": {
+        "description": "Shared Claude Code plugin for frontend teams"
+    },
+    "plugins": [
+        {
+            "name": "frontend-craft",
+            "source": "./",
+            "description": "Enterprise frontend team Claude Code plugin — 13 agents, 40 skills, 8 commands, shared rule templates, and production-ready hooks for code review, TypeScript review, type-safety modeling, state management, Tailwind design systems, responsive layout, dependency upgrades, security review, testing strategy, E2E, component testing, route protection, API integration, interaction motion, performance optimization, scaffolding, design-to-code (Figma/Sketch/MasterGo/Pixso/墨刀/摹客), UI design and polish, Vite standards, legacy-to-modern migration, React/Vue/Next.js/Nuxt/monorepo standards, PWA, Web Workers, Canvas/Three.js, SVG animation, CI/CD, architecture planning, and UI debugging with multi-design-tool MCP integration. All reports auto-saved as Markdown files to reports/ directory.",
+            "version": "2.5.0",
+            "author": {
+                "name": "Bovin Phang",
+                "email": "pengbaowen@msn.com"
+            },
+            "homepage": "https://github.com/bovinphang/frontend-craft",
+            "repository": "https://github.com/bovinphang/frontend-craft",
+            "license": "MIT",
+            "keywords": [
+                "frontend",
+                "vue3",
+                "react",
+                "figma",
+                "sketch",
+                "mastergo",
+                "pixso",
+                "modao",
+                "mockplus",
+                "qoder",
+                "mcp",
+                "design-to-code",
+                "enterprise",
+                "performance"
+            ],
+            "category": "workflow",
+            "tags": [
+                "frontend",
+                "vue3",
+                "react",
+                "figma",
+                "sketch",
+                "mastergo",
+                "pixso",
+                "modao",
+                "qoder",
+                "mcp",
+                "design-to-code",
+                "enterprise",
+                "security",
+                "i18n"
+            ],
+            "strict": false
+        }
+    ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,32 @@
+{
+    "name": "frontend-craft",
+    "version": "2.5.0",
+    "description": "Shared Claude Code plugin for frontend teams, including frontend skills, subagents, hooks, and MCP integration for Figma/Sketch/MasterGo/Pixso/墨刀/摹客. All reports auto-saved as Markdown files.",
+    "author": {
+        "name": "Bovin Phang",
+        "email": "pengbaowen@msn.com"
+    },
+    "license": "MIT",
+    "keywords": [
+        "frontend",
+        "vue3",
+        "react",
+        "figma",
+        "sketch",
+        "mastergo",
+        "pixso",
+        "modao",
+        "mockplus",
+        "mcp",
+        "design-to-code",
+        "claude-code",
+        "codex",
+        "cursor",
+        "openclaw",
+        "opencode",
+        "gemini-cli",
+        "qoder",
+        "windsurf",
+        "copilot"
+    ]
+}

package/.mcp.json

@@ -0,0 +1,44 @@
+{
+    "mcpServers": {
+        "figma": {
+            "command": "npx",
+            "args": ["-y", "figma-developer-mcp", "--stdio"],
+            "env": {
+                "FIGMA_API_KEY": "${FIGMA_API_KEY}"
+            }
+        },
+        "figma-desktop": {
+            "command": "npx",
+            "args": ["-y", "@anthropic/figma-mcp"],
+            "env": {
+                "FIGMA_API_KEY": "${FIGMA_API_KEY}"
+            }
+        },
+        "sketch": {
+            "command": "npx",
+            "args": ["-y", "sketch-mcp-server", "--stdio"],
+            "env": {
+                "SKETCH_API_KEY": "${SKETCH_API_KEY}"
+            }
+        },
+        "mastergo": {
+            "command": "npx",
+            "args": [
+                "-y",
+                "@mastergo/magic-mcp",
+                "--token=${MG_MCP_TOKEN}",
+                "--url=https://mastergo.com"
+            ]
+        },
+        "pixso": {
+            "url": "http://localhost:3667/mcp"
+        },
+        "modao": {
+            "command": "npx",
+            "args": ["-y", "@modao-mcp/modao-proto-mcp"],
+            "env": {
+                "MODAO_TOKEN": "${MODAO_TOKEN}"
+            }
+        }
+    }
+}

package/CHANGELOG.md

@@ -0,0 +1,229 @@
+# Changelog
+
+**简体中文:** [CHANGELOG.zh-CN.md](CHANGELOG.zh-CN.md)
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Project-facing release notes are maintained in English from 2.0.0 onward. Historical entries may preserve their original language.
+
+
+
+## [2.5.0] - 2026-06-01
+
+### Added
+
+- **`init` alias and `fec` shortcut:** added `init` as an alias for `install --local` with local-default behavior; exposed `fec` as an additional bin command alongside `frontend-craft` in `package.json`.
+- **Uninstall/remove commands:** added `frontend-craft uninstall` and `frontend-craft remove` that remove manifest-managed files; support `--force` to include user-modified files; discover existing manifest installs across runtimes and scopes.
+- **Update without runtime:** `frontend-craft update` now supports running without specifying a runtime, refreshing all discovered installs automatically.
+- **Manifest root hints:** manifest file tracking now supports root hints (baseDir/cwd/home) for multi-location file management.
+
+### Fixed
+
+- **Runtime install source conflicts:** added detection and interactive resolution when the same runtime is installed from different sources (e.g. marketplace vs CLI); prevents accidental overwrites and guides users through conflict resolution.
+
+### Changed
+
+- **Installation documentation:** updated README installation sections across all 5 locales with runtime selection options, uninstall/remove command documentation, and source conflict guidance.
+- **README sync:** synchronized agent names, design tools, rule file counts, badges, and wording across all README translations.
+
+### Chore
+
+- **Type safety:** added JSDoc type annotations to `design-system.mjs` and enhanced the `typecheck` script to cover skill scripts.
+- **Metadata formatting:** normalized JSON formatting in marketplace and skills metadata files.
+
+## [2.4.0] - 2026-05-29
+
+### Added
+
+- **Debug workflow:** added `fec-debug` slash command with type-based routing, `fec-debugger` agent for complex diagnostic scenarios, and `fec-debug-framework` skill with a 5-step diagnostic methodology.
+- **6 new skills:** `fec-performance-optimization` (Core Web Vitals, memory leaks, performance budgets), `fec-source-driven-development` (evidence-based decisions with official-docs verification), `fec-state-management` (state architecture patterns), `fec-typescript-type-safety` (type safety enforcement), `fec-dependency-upgrade` (upgrade planning), `fec-responsive-layout` (responsive layout strategy), and `fec-tailwind-design-system` (Tailwind-based design system implementation).
+- **2 new integration skills:** `fec-api-integration` and `fec-motion-interaction`.
+- **Example prompts library:** added `docs/example-prompts.md` and `docs/zh-CN/example-prompts.md` with scenario-based prompt catalogs covering skills, agents, commands, design workflows, testing, maintenance, and runtime setup; linked from all README variants.
+- **UI design system generator:** added `design-system.mjs` generator with product rules, style archetypes, UX quality and Stack UI rules data packages; supports `--persist` and `--page` flags to write `MASTER.md` and page overrides.
+
+### Changed
+
+- **Agent renaming:** renamed 8 agents from `fec-frontend-*` to shorter `fec-*` prefix; replaced `fec-frontend-code-review` skill with `fec-code-review`.
+- **Skill consolidation:** merged `fec-interface-polish` and `fec-ui-design-direction` into a unified `fec-ui-design` skill covering both product-level visual direction and detail-level polish.
+- **UI design enhancement:** enhanced `fec-ui-design` with design-system generation, Master/Page overrides, chart UX, color rhythm, visual texture, anti-generic polish, and visual identity checks.
+- **Skill taxonomy:** refined from 4 to 7 categories — `implementation-capability`, `testing`, `review-quality`, `design-ui`, `legacy-migration`, `maintenance-docs`; updated README tables across all 5 locales.
+- **Unified planning entry:** merged `/fec-test-plan` into `/fec-plan`, which now auto-routes to implementation or test strategy based on user intent; updated all README variants, openclaw docs, example prompts, project structure, and marketplace metadata (9 → 8 commands).
+- **Rules naming:** renamed all template shared rules with `fec-` prefix for consistent naming convention; updated README, CHANGELOG, agents, commands, skills, installers, and tests.
+- **Skill descriptions:** refined skill descriptions, prompt examples, and README formatting; clarified `fec-storybook-component-doc` scope to component documentation, design-system presentation, and isolated state previews.
+
+### Fixed
+
+- **Skill relations:** decoupled skill relations from agent navigation to prevent incorrect cross-references.
+
+### Removed
+
+- `/fec-build-fix` slash command and `fec-build-fixer` agent — superseded by the new debug workflow.
+- `/fec-test-plan` slash command — test-planning intent is now handled by `/fec-plan`.
+- `fec-interface-polish` and `fec-ui-design-direction` skills — merged into `fec-ui-design`.
+
+## [2.3.1] - 2026-05-25
+
+### Added
+
+- **Claude cache cleanup hook:** added `fec-cleanup-claude-cache` hook for automatic Claude cache management during session start.
+- **Cache diagnostics:** added `--fix-cache` and `--dry-run` flags to `frontend-craft doctor claude` for inspecting and cleaning stale cache entries.
+- **New module:** `src/install/claude-cache.ts` with cache report generation, cleanup logic, and result rendering.
+- **Hook registration:** registered `fec-cleanup-claude-cache` in `hooks/hooks.json` and `scripts/build-dist.ts`.
+
+### Changed
+
+- **Doctor command:** extended `doctor` report to include Claude cache status when runtime is `claude`.
+- **Install documentation:** clarified Claude Code Marketplace as the preferred single-source install for Claude Code users; documented that CLI install/update refuses Marketplace-managed Claude installs even with `--force`, and that CLI local/global conflicts must be resolved by updating the existing source or uninstalling before switching.
+- **Test coverage:** added `tests/install/claude-cache.test.ts`; expanded end-to-end, metadata consistency, and update test coverage.
+
+## [2.3.0] - 2026-05-22
+
+### Added
+
+- Added new workflow capabilities: `fec-tdd-workflow`, `fec-refactor-clean`, `fec-doc-sync`, `/fec-plan`, `/fec-tdd`, `/fec-build-fix`, `/fec-refactor-clean`, `/fec-doc-sync`, plus `fec-build-fixer`, `fec-refactor-cleaner`, and `fec-doc-updater`.
+- Added shared rules for agent workflow and working modes, and expanded testing, performance, refactoring, git, and comment rules with TDD, incremental validation, cleanup, and documentation-sync guidance.
+- **Update/upgrade commands:** added `frontend-craft update` and `frontend-craft upgrade` with manifest-based file protection, allowing safe in-place updates without overwriting user-modified files.
+- **esbuild minification:** added an esbuild minification step to the build pipeline, producing smaller compiled output for `dist/`.
+- **Version sync script:** added `scripts/sync-version.ts` to propagate the package version across plugin metadata files, keeping `package.json`, `openclaw.json`, and skill manifests in lockstep.
+
+### Changed
+
+- Enhanced `fec-validation-fix` with incremental build-fix behavior and added cross-platform long-running command guidance in the Node security hook.
+- **Build pipeline restructure:** moved hook scripts from `hooks/` to `src/hooks/`, switched the build pipeline to tsx-based compilation, bundled the CLI entry point into `dist/bin/`, and stopped publishing `dist/src/` in the npm package.
+- **Install module type annotations:** added comprehensive TypeScript type annotations to the install module for improved type safety and editor support.
+- **README layout:** replaced the detailed directory tree with a concise summary and a link to the full project structure documentation.
+- **CONTRIBUTING guides:** updated `CONTRIBUTING.md` and `CONTRIBUTING.zh-CN.md` to reflect the tsx-based build pipeline and the hook script relocation to `src/hooks/`.
+
+### Fixed
+
+- **Install mkdir:** skipped `mkdir` when the target directory already exists, preventing unnecessary errors during repeated installs.
+
+## [2.2.1] - 2026-05-21
+
+### Added
+
+- **Qoder runtime support:** added the `qoder` installer, runtime documentation, capability metadata, README coverage, and marketplace keywords. The universal installer now documents and supports 15 AI coding runtimes.
+- **Testing strategy workflow:** added `fec-test-planner`, `/fec-test-plan`, and `fec-testing-strategy` for risk-based frontend test planning across static checks, unit, component, integration, E2E, visual, accessibility, security, and performance layers.
+- **New frontend workflow skills:** added `fec-ui-design-direction`, `fec-interface-polish`, and `fec-vite-project-standard`; replaced the former validation workflow with `fec-validation-fix`.
+- **Standalone skill publishing pipeline:** added `scripts/pack-skills.ts`, `scripts/check-skills-publish.ts`, shared skill packaging helpers, `npm run pack:skills`, `npm run check:skills-publish`, and `npm run pack:all` for generating and validating one publishable package per skill.
+- **CLI diagnostics and metadata checks:** added `frontend-craft matrix`, `frontend-craft doctor <runtime>`, and `frontend-craft sync-metadata --check` to inspect runtime capabilities, installation health, and public metadata consistency.
+- **Skill evaluation dataset:** added `skills/eval_queries.json` for validating skill discovery and routing quality.
+
+### Changed
+
+- **TypeScript migration:** migrated the universal CLI, installers, runtime converters, hook scripts, OpenClaw packaging scripts, and tests from `.mjs` to TypeScript, with compiled runtime entry points under `dist/`.
+- **Agentskills-compatible skill layout:** normalized all skill directories to the `fec-*` naming scheme, added frontmatter and reference-file structure, expanded `skills/metadata.json` to 28 skills, and synchronized README skill trees across English, Simplified Chinese, Traditional Chinese, Japanese, and Korean docs.
+- **Runtime capability model:** introduced explicit per-runtime capability tiers for skills, agents, commands, hooks, rules, templates, MCP, reports, and init behavior so installer output and docs reflect each runtime accurately.
+- **Claude/OpenClaw packaging metadata:** refreshed plugin descriptions, supported runtime keywords, and hook command examples to match the TypeScript build output and the current 10-agent / 28-skill / 4-command surface.
+- **Publish artifact layout:** `pack:skills` now writes standalone skill packages to root `skill-packages/` instead of `dist/skill-packages/`, keeping publishable skill packages separate from TypeScript build output.
+- **Clean TypeScript builds:** `npm run build` now removes `dist/` before compiling so stale generated JavaScript cannot survive into later package outputs.
+
+### Fixed
+
+- **Root npm package contents:** tightened the npm `files` manifest so `npm pack` publishes compiled `dist/` runtime JavaScript and plugin assets without leaking TypeScript source directories (`bin/`, `src/`, or `scripts/`).
+- **Packaging regression coverage:** added npm pack validation that rejects leaked TypeScript sources, stale compiled files without matching source files, and accidental inclusion of standalone `skill-packages/` in the root npm package.
+
+### Removed
+
+- Removed legacy unprefixed skill directories after migrating them to the `fec-*` layout.
+- Removed stale migration and skills-fusion assessment documents that no longer matched the current package structure.
+
+## [2.1.2] - 2026-05-20
+
+### Changed
+
+- **CONTRIBUTING docs:** expanded `CONTRIBUTING.md` and `CONTRIBUTING.zh-CN.md` with project structure overview, local development and debugging guide, testing instructions (Node.js `node:test`, single-file runs, interactive mode via `FRONTEND_CRAFT_FORCE_INTERACTIVE=1`), OpenClaw build pipeline (`build`/`typecheck`/`pack`), `scripts/` directory reference table, and installer architecture diagram.
+
+- **OpenClaw package renamed:** `frontend-craft-openclaw` → `frontend-craft`. The npm package name, tarball filename, and README references are all updated. The packed tarball is now written to `npm-packages/openclaw/` instead of the repository root. Affects `scripts/openclaw/pack-openclaw.ts`, `README.md`, `README.zh-CN.md`, `README.openclaw.md`, `README.openclaw.zh-CN.md`, and `docs/MIGRATION-FROM-LEGACY-REPOS.md`. Historical CHANGELOG entries for 2.0.0/2.0.1 also corrected.
+
+- **Interactive installer:** replaced numeric-choice prompts with a TTY-interactive selectable prompt system featuring ↑↓ navigation, Space toggle, Backspace to remove, search filtering, and pagination. Affects `src/install/interactive.ts` and adds new test coverage in `tests/install/cli.test.ts`.
+
+## [2.1.1] - 2026-05-19
+
+### Added
+
+- **11 new skills**: `fec-data-fetching` (TanStack Query), `fec-form-handling` (React Hook Form + Zod), `fec-browser-storage` (client persistence), `fec-route-protection` (auth/permission routes), `fec-component-testing` (RTL / Vue Test Utils), `fec-storybook-component-doc` (Storybook docs), `fec-list-virtualization` (react-window / TanStack Virtual), `fec-pwa-implementation` (PWA), `fec-web-workers` (Web Worker), `fec-canvas-threejs` (Canvas/Three.js/R3F), `fec-svg-animation` (SVG motion).
+- **Shared rules**: `responsive-design.md`, `rendering-patterns.md` — deployed via `/fec-init`.
+- **metadata consistency test**: `tests/install/metadata-consistency.test.ts` validates that `skills/metadata.json`, README tables, and marketplace description stay in sync.
+
+### Changed
+
+- **Agent behavior (`fec-code-reviewer`):** report-only by default — no longer modifies business files unless explicitly requested.
+- **Skill structure**: React, Vue, Next.js, Nuxt, Monorepo, legacy-web, legacy-migration, and implement-from-design skills aligned to a five-section template: Purpose / When to Use / Procedure / Constraints / Expected Output.
+- **Scaffold templates**: fixed React CSS import (`import './<Name>.styles.css'` instead of `import styles from ...`); Vue scaffold uses `<slot />` instead of bare component tag.
+- **Marketplace description**: skills count updated from 13 → 24, with new capabilities (component testing, route protection, PWA, Web Workers, Canvas/Three.js, SVG animation).
+- **Skills fusion assessment** (`docs/skills-fusion-assessment.md`): condensed from 399 lines to a 64-line reference with coverage matrix.
+
+## [2.0.1] - 2026-05-14
+
+### Fixed
+
+- **Claude Code plugin hooks:** `hooks/hooks.json` now references bundled scripts with **`${CLAUDE_PLUGIN_ROOT}`**, which Claude Code substitutes for marketplace and `--plugin-dir` loads. **`${FRONTEND_CRAFT_ROOT}`** is not substituted by the runtime and could break hooks on **Windows + Git Bash** (an empty prefix made `/scripts/...` resolve under the Git for Windows installation directory).
+
+### Changed
+
+- **Version:** 2.0.1 across the root npm package, `.claude-plugin` manifests, `openclaw.plugin.json`, and the **`frontend-craft`** staging package under `npm-packages/openclaw/`.
+
+## [2.0.0] - 2026-05-14
+
+### Added
+
+- **Universal CLI** `frontend-craft`: `install`, `list`, `version`, `uninstall` (hints); supports runtimes: Claude Code, Codex, Cursor, Windsurf, OpenCode, Kilo, Gemini CLI, Copilot, Antigravity, Augment, Trae, CodeBuddy, Cline, OpenClaw (`src/install/`, `bin/frontend-craft.ts`). Interactive wizard when you run `npx frontend-craft` / `install` with no runtime (TTY), plus `--local` / `-l` for project installs.
+- **Root `package.json`** with Node 22+ engines, npm `files` manifest, tests via `node --test`.
+- **`templates/shared/rules`** + **`templates/claude/`** layout; Codex templates under **`templates/codex/`**; OpenClaw templates under **`templates/openclaw/`**.
+- **`openclaw.plugin.json`** and **`src/openclaw/`** TypeScript plugin (from former `frontend-craft-openclaw`); build via `npm run build:openclaw`, pack via `npm run pack:openclaw` → **`frontend-craft-<version>.tgz`** under **`npm-packages/openclaw/`** (staging uses `npm-packages/openclaw/` during the pack).
+- **`docs/runtimes/*.md`** per-runtime install stubs (with non-interactive `--local` / `--global` reminders).
+- **`LICENSE`** (MIT).
+- **Open source governance**: English `CONTRIBUTING.md`, **Simplified Chinese** `CONTRIBUTING.zh-CN.md`, `SECURITY.md` / `SECURITY.zh-CN.md`, `CODE_OF_CONDUCT.md` / `CODE_OF_CONDUCT.zh-CN.md`, `CHANGELOG.zh-CN.md`, GitHub issue templates, pull request template, and CI workflow.
+
+### Changed
+
+- **CLI install UX:** non-interactive terminals default missing runtime / missing install scope to **global `claude`** with console notices; TTY installs can prompt for Global vs Local unless `--global` / `--local` is passed; `install --help` / `--help` on the install argv prints help without installing.
+- **Hooks** and docs now use **`${FRONTEND_CRAFT_ROOT}`** for script paths (installer still expands legacy `${CLAUDE_PLUGIN_ROOT}` for compatibility).
+- **Slash commands** now use the collision-resistant **`/fec-*`** prefix: `/fec-init`, `/fec-review`, `/fec-scaffold`. Legacy root commands (`/init`, `/review`, `/scaffold`) and `/frontend-craft:*` command names are no longer published.
+- **`commands/fec-init.md`** updated for new template paths.
+- **`scripts/sync-codex-agents-toml.ts`** requires **`CODEX_AGENTS_DIR`** (no longer writes into this repo by default).
+- **README files** now link to contributing, security, code of conduct, and CI status for international contributors.
+
+### Removed
+
+- Top-level **`templates/rules/`** (moved to `templates/shared/rules/`); **`templates/CLAUDE.md`** / **`templates/settings.json`** moved to **`templates/claude/`**.
+
+## [1.1.0] - 2026-03-18
+
+### Added
+
+- `fec-legacy-to-modern-migration` skill — jQuery/MPA 迁移至 React/Vue 3 + TS 的策略与流程
+- `fec-e2e-testing` skill — Playwright/Cypress E2E 测试规范
+- `fec-nextjs-project-standard` skill — Next.js 项目规范（App Router、SSR/SSG）
+- `fec-nuxt-project-standard` skill — Nuxt 3 项目规范（SSR/SSG）
+- `fec-monorepo-project-standard` skill — Monorepo 项目规范
+- `rules/fec-ci-cd.md` 模板 — CI/CD 流水线规范
+- `rules/fec-refactoring.md` 模板 — 重构项目约束（图片、样式、功能等价）
+- CONTRIBUTING.md — 贡献指南
+- CHANGELOG.md — 版本变更记录
+
+### Changed
+
+- `testing.md` — 补充 E2E 测试规则
+- `fec-architect` agent — 增加 `fec-legacy-to-modern-migration` skill 引用
+- `fec-legacy-to-modern-migration` skill — 新增重构实施要求：图片（使用原项目资源、禁止内联 SVG）、样式（参考效果不照搬 CSS、优先 flex、禁止内联样式）、目标（视觉交互一致、功能等价、代码更简洁易维护）
+
+---
+
+## [1.0.0] - 2026-03-18
+
+### Added
+
+- 初始发布
+- 5 个 Agents：fec-architect、performance-optimizer、ui-checker、figma-implementer、design-token-mapper
+- 9 个 Skills：fec-code-review、fec-security-review、fec-accessibility-check、fec-react-project-standard、fec-vue3-project-standard、fec-implement-from-design、fec-test-and-fix、fec-legacy-web-standard、fec-legacy-to-modern-migration
+- 3 个 Commands：init、review、scaffold
+- Hooks：SessionStart、PreToolUse、PostToolUse、Stop、Notification
+- 11 个规则模板：CLAUDE.md、settings.json、vue、react、design-system、testing、git-conventions、i18n、performance、api-layer、state-management、error-handling、naming-conventions
+- MCP 集成：Figma、Sketch、MasterGo、Pixso、墨刀
+- 多语言 README：English、简体中文、繁體中文、日本語、한국어
+- 报告自动保存为 Markdown 至 `reports/` 目录

package/CHANGELOG.zh-CN.md

@@ -0,0 +1,228 @@
+# 变更日志
+
+> **English:** [CHANGELOG.md](CHANGELOG.md)
+
+本文件为 [CHANGELOG.md](CHANGELOG.md) 的简体中文镜像，便于中文读者阅读；版本与条目与英文版保持一致。
+
+格式参考 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+自 **2.0.0** 起，面向发布的说明以英文 `CHANGELOG.md` 为权威来源；历史条目可能保留最初撰写语言。
+
+
+
+## [2.5.0] - 2026-06-01
+
+### 新增
+
+- **`init` 别名与 `fec` 快捷命令**：新增 `init` 作为 `install --local` 的别名，默认执行本地安装；在 `package.json` 中将 `fec` 作为 `frontend-craft` 的额外 bin 命令暴露。
+- **卸载/移除命令**：新增 `frontend-craft uninstall` 和 `frontend-craft remove`，用于移除 manifest 管理的文件；支持 `--force` 以包含用户已修改的文件；可跨 runtime 和安装范围发现已有的 manifest 安装。
+- **无 runtime 更新**：`frontend-craft update` 现在支持不指定 runtime 运行，自动刷新所有已发现的安装。
+- **Manifest 根提示**：manifest 文件跟踪新增根提示（baseDir/cwd/home），支持多位置文件管理。
+
+### 修复
+
+- **Runtime 安装源冲突**：新增检测与交互式解决机制，当同一 runtime 从不同来源（如 Marketplace 与 CLI）安装时，防止意外覆盖并引导用户完成冲突解决。
+
+### 变更
+
+- **安装文档**：更新所有 5 种语言的 README 安装章节，补充 runtime 选择选项、卸载/移除命令文档和源冲突指引。
+- **README 同步**：同步所有 README 翻译中的 Agent 名称、设计工具、规则文件数量、徽章和措辞。
+
+### 工程
+
+- **类型安全**：为 `design-system.mjs` 补充 JSDoc 类型注解，并扩展 `typecheck` 脚本以覆盖 skill 脚本。
+- **元数据格式**：统一 marketplace 和 skills 元数据文件的 JSON 格式。
+
+## [2.4.0] - 2026-05-29
+
+### 新增
+
+- **调试工作流**：新增 `/fec-debug` 斜杠命令（按类型自动路由）、`fec-debugger` agent（复杂诊断场景）和 `fec-debug-framework` skill（5 步诊断方法论）。
+- **6 个新技能**：`fec-performance-optimization`（Core Web Vitals、内存泄漏、性能预算）、`fec-source-driven-development`（基于官方文档验证的证据驱动决策）、`fec-state-management`（状态架构模式）、`fec-typescript-type-safety`（类型安全强化）、`fec-dependency-upgrade`（依赖升级规划）、`fec-responsive-layout`（响应式布局策略）和 `fec-tailwind-design-system`（基于 Tailwind 的设计系统实现）。
+- **2 个新集成技能**：`fec-api-integration` 和 `fec-motion-interaction`。
+- **示例提示库**：新增 `docs/example-prompts.md` 和 `docs/zh-CN/example-prompts.md`，涵盖技能、Agent、命令、设计工作流、测试、维护和运行时配置等场景化提示目录；已在所有 README 变体中添加链接。
+- **UI 设计系统生成器**：新增 `design-system.mjs` 生成器，包含产品规则、风格原型、UX 质量和 Stack UI 规则数据包；支持 `--persist` 和 `--page` 标志生成 `MASTER.md` 和页面覆盖。
+
+### 变更
+
+- **Agent 重命名**：将 8 个 Agent 从 `fec-frontend-*` 重命名为更短的 `fec-*` 前缀；将 `fec-frontend-code-review` 技能替换为 `fec-code-review`。
+- **技能合并**：将 `fec-interface-polish` 和 `fec-ui-design-direction` 合并为统一的 `fec-ui-design` 技能，同时覆盖产品级视觉方向和细节级打磨。
+- **UI 设计增强**：为 `fec-ui-design` 新增设计系统生成、Master/Page 覆盖、图表 UX、色彩韵律、视觉纹理、反泛化打磨和视觉识别检查。
+- **技能分类**：从 4 个类别细化为 7 个——`implementation-capability`、`testing`、`review-quality`、`design-ui`、`legacy-migration`、`maintenance-docs`；已同步更新 5 种语言的 README 表格。
+- **统一规划入口**：将 `/fec-test-plan` 合并到 `/fec-plan`，根据用户意图自动分流到实施规划或测试策略规划；已更新所有 README 变体、openclaw 文档、示例提示、项目结构和 Marketplace 元数据（9 → 8 个命令）。
+- **规则命名**：所有模板共享规则统一添加 `fec-` 前缀；已更新 README、CHANGELOG、Agent、命令、技能、安装器和测试。
+- **技能描述**：优化技能描述、提示示例和 README 排版；明确 `fec-storybook-component-doc` 的范围为组件文档、设计系统展示和隔离状态预览。
+
+### 修复
+
+- **技能关系**：将技能关系与 Agent 导航解耦，防止错误的交叉引用。
+
+### 移除
+
+- `/fec-build-fix` 斜杠命令和 `fec-build-fixer` Agent——已被新的调试工作流取代。
+- `/fec-test-plan` 斜杠命令——测试规划意图现由 `/fec-plan` 统一处理。
+- `fec-interface-polish` 和 `fec-ui-design-direction` 技能——已合并到 `fec-ui-design`。
+
+## [2.3.1] - 2026-05-25
+
+### 新增
+
+- **Claude 缓存清理 hook**：新增 `fec-cleanup-claude-cache` hook，用于在会话启动时自动管理 Claude 缓存。
+- **缓存诊断**：为 `frontend-craft doctor claude` 新增 `--fix-cache` 和 `--dry-run` 参数，用于检查和清理过期缓存条目。
+- **新模块**：`src/install/claude-cache.ts`，提供缓存报告生成、清理逻辑和结果渲染。
+- **Hook 注册**：在 `hooks/hooks.json` 和 `scripts/build-dist.ts` 中注册 `fec-cleanup-claude-cache`。
+
+### 变更
+
+- **Doctor 命令**：扩展 `doctor` 报告，当 runtime 为 `claude` 时自动显示 Claude 缓存状态。
+- **安装文档**：明确 Claude Code Marketplace 作为 Claude Code 用户的首选单一安装来源；记录 CLI install/update 即使带 `--force` 也会拒绝 Marketplace 管理的 Claude 安装，并说明 CLI local/global 冲突需保持已安装来源更新，或先卸载再切换。
+- **测试覆盖**：新增 `tests/install/claude-cache.test.ts`；扩展 end-to-end、metadata 一致性及 update 测试覆盖。
+
+## [2.3.0] - 2026-05-22
+
+### 新增
+
+- 新增工作流能力：`fec-tdd-workflow`、`fec-refactor-clean`、`fec-doc-sync`、`/fec-plan`、`/fec-tdd`、`/fec-build-fix`、`/fec-refactor-clean`、`/fec-doc-sync`，以及 `fec-build-fixer`、`fec-refactor-cleaner`、`fec-doc-updater`。
+- 新增 agent workflow 与 working modes 共享规则，并扩展 testing、performance、refactoring、git、comment 规则，补充 TDD、增量验证、清理和文档同步指导。
+- **更新/升级命令**：新增 `frontend-craft update` 和 `frontend-craft upgrade`，基于 manifest 文件保护机制，支持安全就地更新而不会覆盖用户已修改的文件。
+- **esbuild 压缩**：在构建流水线中新增 esbuild 压缩步骤，使 `dist/` 编译产物更小。
+- **版本同步脚本**：新增 `scripts/sync-version.ts`，在 `package.json`、`openclaw.json` 及 skill manifest 之间自动传播版本号，保持各元数据文件一致。
+
+### 变更
+
+- 增强 `fec-validation-fix` 的增量 build-fix 行为，并在 Node 安全 hook 中加入跨平台长命令日志提示。
+- **构建流水线重构**：将 hook 脚本从 `hooks/` 迁移至 `src/hooks/`，构建流水线切换为 tsx 编译，CLI 入口打包至 `dist/bin/`，npm 发布包不再包含 `dist/src/`。
+- **安装模块类型注解**：为安装模块补充完整的 TypeScript 类型标注，提升类型安全与编辑器体验。
+- **README 布局**：将详细目录树替换为简要摘要与完整项目结构文档的链接。
+- **CONTRIBUTING 文档**：更新 `CONTRIBUTING.md` 与 `CONTRIBUTING.zh-CN.md`，反映 tsx 构建流水线及 hook 脚本迁移至 `src/hooks/` 的变更。
+
+### 修复
+
+- **安装 mkdir**：目标目录已存在时跳过 `mkdir`，避免重复安装时产生不必要的错误。
+
+## [2.2.1] - 2026-05-21
+
+### 新增
+
+- **Qoder runtime 支持**：新增 `qoder` 安装器、runtime 文档、能力元数据、README 说明和 Marketplace 关键词。通用安装器现在记录并支持 15 个 AI coding runtime。
+- **测试策略工作流**：新增 `fec-test-planner`、`/fec-test-plan` 和 `fec-testing-strategy`，用于按风险规划前端测试层级，覆盖静态检查、单元、组件、集成、E2E、视觉、无障碍、安全与性能等维度。
+- **新前端工作流技能**：新增 `fec-ui-design-direction`、`fec-interface-polish` 和 `fec-vite-project-standard`；原验证修复流程改为 `fec-validation-fix`。
+- **独立 skill 发布管线**：新增 `scripts/pack-skills.ts`、`scripts/check-skills-publish.ts`、共享 skill 打包工具，以及 `npm run pack:skills`、`npm run check:skills-publish`、`npm run pack:all`，可为每个 skill 生成并校验独立可发布包。
+- **CLI 诊断与 metadata 检查**：新增 `frontend-craft matrix`、`frontend-craft doctor <runtime>` 和 `frontend-craft sync-metadata --check`，用于查看 runtime 能力矩阵、安装健康状态与公开 metadata 一致性。
+- **Skill 评估数据集**：新增 `skills/eval_queries.json`，用于验证 skill 发现与路由质量。
+
+### 变更
+
+- **TypeScript 迁移**：将通用 CLI、安装器、runtime 转换器、hook 脚本、OpenClaw 打包脚本和测试从 `.mjs` 迁移到 TypeScript，并通过 `dist/` 下的编译产物作为运行入口。
+- **Agentskills 兼容的 skill 布局**：所有 skill 目录统一为 `fec-*` 命名，补充 frontmatter 与 references 文件结构，将 `skills/metadata.json` 扩展至 28 个 skills，并同步英文、简体中文、繁体中文、日文和韩文 README 的技能目录树。
+- **Runtime 能力模型**：新增显式的 runtime 能力分层，覆盖 skills、agents、commands、hooks、rules、templates、MCP、reports 与 init 行为，使安装器输出和文档能准确反映不同 runtime 的支持范围。
+- **Claude/OpenClaw 打包元数据**：刷新插件描述、支持的 runtime 关键词与 hook 命令示例，使其匹配 TypeScript 构建产物以及当前 10 agents / 28 skills / 4 commands 的能力范围。
+- **发布产物布局**：`pack:skills` 现在将独立 skill 发布包写入根目录 `skill-packages/`，不再写入 `dist/skill-packages/`，让独立发布包与 TypeScript 构建产物分离。
+- **干净的 TypeScript 构建**：`npm run build` 现在会在编译前清理 `dist/`，避免历史生成的 JavaScript 文件混入后续打包产物。
+
+### 修复
+
+- **根 npm 包内容**：收紧 npm `files` 清单，`npm pack` 只发布编译后的 `dist/` 运行时代码和插件资产，不再泄漏 `bin/`、`src/`、`scripts/` 下的 TypeScript 源码。
+- **打包回归测试**：新增 npm pack 校验，防止 TypeScript 源码泄漏、无对应源码的陈旧编译文件残留，以及根 npm 包误包含独立 `skill-packages/`。
+
+### 移除
+
+- 迁移到 `fec-*` 布局后，移除旧的无前缀 skill 目录。
+- 移除已不匹配当前包结构的旧迁移文档与 skills fusion 评估文档。
+
+## [2.1.2] - 2026-05-20
+
+### 变更
+
+- **CONTRIBUTING 文档**：完善 `CONTRIBUTING.md` 与 `CONTRIBUTING.zh-CN.md`，新增项目结构概览、本地开发与调试指南、测试说明（Node.js `node:test`、单文件运行、通过 `FRONTEND_CRAFT_FORCE_INTERACTIVE=1` 测试交互模式）、OpenClaw 构建管线（`build`/`typecheck`/`pack`）、`scripts/` 目录参考表，以及安装器架构关系图。
+
+- **OpenClaw 包重命名**：`frontend-craft-openclaw` → `frontend-craft`。npm 包名、tarball 文件名及 README 引用全部更新。打包产物改写入 `npm-packages/openclaw/` 而非仓库根目录。影响 `scripts/openclaw/pack-openclaw.ts`、`README.md`、`README.zh-CN.md`、`README.openclaw.md`、`README.openclaw.zh-CN.md` 及 `docs/MIGRATION-FROM-LEGACY-REPOS.md`。CHANGELOG 中 2.0.0/2.0.1 历史条目也已同步修正。
+
+- **交互式安装向导**：将数字选择提示升级为 TTY 交互式可选 prompt 系统，支持 ↑↓ 导航、Space 切换、Backspace 删除、搜索过滤和分页。影响 `src/install/interactive.ts`，并在 `tests/install/cli.test.ts` 中新增测试覆盖。
+
+## [2.1.1] - 2026-05-19
+
+### 新增
+
+- **11 个新技能**：`fec-data-fetching`（TanStack Query）、`fec-form-handling`（React Hook Form + Zod）、`fec-browser-storage`（客户端持久化）、`fec-route-protection`（权限路由）、`fec-component-testing`（RTL / Vue Test Utils）、`fec-storybook-component-doc`（Storybook 文档）、`fec-list-virtualization`（react-window / TanStack Virtual）、`fec-pwa-implementation`（PWA）、`fec-web-workers`（Web Worker）、`fec-canvas-threejs`（Canvas/Three.js/R3F）、`fec-svg-animation`（SVG 动画）。
+- **共享规则**：`responsive-design.md`、`rendering-patterns.md` — 通过 `/fec-init` 部署。
+- **metadata 一致性测试**：`tests/install/metadata-consistency.test.ts` 校验 `skills/metadata.json`、README 表格与 Marketplace 描述保持同步。
+
+### 变更
+
+- **Agent 行为（`fec-code-reviewer`）**：默认只输出评审报告，不再修改业务文件，除非用户明确要求。
+- **Skill 结构**：React、Vue、Next.js、Nuxt、Monorepo、legacy-web、legacy-migration、implement-from-design 等技能统一为五段式结构：Purpose / When to Use / Procedure / Constraints / Expected Output。
+- **脚手架模板**：修正 React CSS import（`import './<Name>.styles.css'` 替代模块化导入）；Vue 模板使用 `<slot />` 替代裸组件标签。
+- **Marketplace 描述**：skills 数量从 13 → 24，补充新能力（组件测试、路由保护、PWA、Web Workers、Canvas/Three.js、SVG 动画）。
+- **Skills 融合评估报告**（`docs/skills-fusion-assessment.md`）：从 399 行精简为 64 行结论版，附覆盖矩阵。
+
+## [2.0.1] - 2026-05-14
+
+### 修复
+
+- **Claude Code 插件 hooks：** `hooks/hooks.json` 中引用内置 `dist/scripts/*.js` 时使用 **`${CLAUDE_PLUGIN_ROOT}`**，以便在 Marketplace 与 **`--plugin-dir`** 加载时由 Claude Code 正确替换插件根路径。运行时**不会**替换 **`${FRONTEND_CRAFT_ROOT}`**，在 **Windows + Git Bash** 下可能导致 hook 解析到 Git 安装目录下的错误路径。
+
+### 变更
+
+- **版本号：** 根 npm 包、`.claude-plugin` 清单、`openclaw.plugin.json` 以及 `npm-packages/openclaw/` 中的 **`frontend-craft`** 暂存包均升至 **2.0.1**。
+
+## [2.0.0] - 2026-05-14
+
+### 新增
+
+- **通用 CLI** `frontend-craft`：`install`、`list`、`version`、`uninstall`（卸载仅为提示）；支持 runtime：Claude Code、Codex、Cursor、Windsurf、OpenCode、Kilo、Gemini CLI、Copilot、Antigravity、Augment、Trae、CodeBuddy、Cline、OpenClaw（`src/install/`、`bin/frontend-craft.ts`）。在 TTY 下执行 `npx frontend-craft` / 无 runtime 的 `install` 可进入交互向导；支持 `--local` / `-l` 安装到当前项目。
+- **根目录 `package.json`**：Node 22+ `engines`、npm `files` 清单、通过 `node --test` 运行的测试。
+- **`templates/shared/rules`** 与 **`templates/claude/`** 布局；Codex 模板在 **`templates/codex/`**；OpenClaw 模板在 **`templates/openclaw/`**。
+- **`openclaw.plugin.json`** 与 **`src/openclaw/`** TypeScript 插件（由原 `frontend-craft-openclaw` 合并）；`npm run build:openclaw` 构建，`npm run pack:openclaw` 在 **`npm-packages/openclaw/`** 生成 **`frontend-craft-<version>.tgz`**（打包过程会暂存至 `npm-packages/openclaw/`）。
+- **`docs/runtimes/*.md`** 各 runtime 安装摘要（含非交互场景下 `--local` / `--global` 提示）。
+- **`LICENSE`**（MIT）。
+- **开源治理**：英文 `CONTRIBUTING.md`、简体中文 **CONTRIBUTING.zh-CN.md**、`SECURITY.md` / **SECURITY.zh-CN.md**、`CODE_OF_CONDUCT.md` / **CODE_OF_CONDUCT.zh-CN.md**、**CHANGELOG.zh-CN.md**、GitHub Issue 模板、PR 模板与 CI 工作流。
+
+### 变更
+
+- **CLI 安装体验：** 非交互终端在缺少 runtime 或缺少安装范围时，默认 **全局 `claude`** 并打印提示；TTY 下可询问 Global / Local，除非已传入 `--global` / `--local`；`install` 参数中的 `--help` / `-h` / `help` 仅打印帮助，不执行安装。
+- **Hooks** 与文档中的脚本路径改用 **`${FRONTEND_CRAFT_ROOT}`**（安装器仍会将旧占位符 `${CLAUDE_PLUGIN_ROOT}` 展开以兼容）。
+- **斜杠命令** 采用防冲突的 **`/fec-*`** 前缀：`/fec-init`、`/fec-review`、`/fec-scaffold`。旧根命令（`/init`、`/review`、`/scaffold`）及 `/frontend-craft:*` 名称不再发布。
+- **`commands/fec-init.md`** 已按新模板路径更新。
+- **`scripts/sync-codex-agents-toml.ts`** 需要 **`CODEX_AGENTS_DIR`**（默认不再写入本仓库）。
+- **README** 已补充贡献、安全、行为准则与 CI 状态链接，便于国际贡献者。
+
+### 移除
+
+- 顶层 **`templates/rules/`**（迁至 `templates/shared/rules/`）；**`templates/CLAUDE.md`** / **`templates/settings.json`** 迁至 **`templates/claude/`**。
+
+## [1.1.0] - 2026-03-18
+
+### 新增
+
+- `fec-legacy-to-modern-migration` skill — jQuery/MPA 迁移至 React/Vue 3 + TS 的策略与流程
+- `fec-e2e-testing` skill — Playwright/Cypress E2E 测试规范
+- `fec-nextjs-project-standard` skill — Next.js 项目规范（App Router、SSR/SSG）
+- `fec-nuxt-project-standard` skill — Nuxt 3 项目规范（SSR/SSG）
+- `fec-monorepo-project-standard` skill — Monorepo 项目规范
+- `rules/fec-ci-cd.md` 模板 — CI/CD 流水线规范
+- `rules/fec-refactoring.md` 模板 — 重构项目约束（图片、样式、功能等价）
+- CONTRIBUTING.md — 贡献指南
+- CHANGELOG.md — 版本变更记录
+
+### 变更
+
+- `testing.md` — 补充 E2E 测试规则
+- `fec-architect` agent — 增加 `fec-legacy-to-modern-migration` skill 引用
+- `fec-legacy-to-modern-migration` skill — 新增重构实施要求：图片（使用原项目资源、禁止内联 SVG）、样式（参考效果不照搬 CSS、优先 flex、禁止内联样式）、目标（视觉交互一致、功能等价、代码更简洁易维护）
+
+---
+
+## [1.0.0] - 2026-03-18
+
+### 新增
+
+- 初始发布
+- 5 个 Agents：fec-architect、performance-optimizer、ui-checker、figma-implementer、design-token-mapper
+- 9 个 Skills：fec-code-review、fec-security-review、fec-accessibility-check、fec-react-project-standard、fec-vue3-project-standard、fec-implement-from-design、fec-test-and-fix、fec-legacy-web-standard、fec-legacy-to-modern-migration
+- 3 个 Commands：init、review、scaffold
+- Hooks：SessionStart、PreToolUse、PostToolUse、Stop、Notification
+- 11 个规则模板：CLAUDE.md、settings.json、vue、react、design-system、testing、git-conventions、i18n、performance、api-layer、state-management、error-handling、naming-conventions
+- MCP 集成：Figma、Sketch、MasterGo、Pixso、墨刀
+- 多语言 README：English、简体中文、繁體中文、日本語、한국어
+- 报告自动保存为 Markdown 至 `reports/` 目录

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,34 @@
+# Code of Conduct
+
+**简体中文:** [CODE_OF_CONDUCT.zh-CN.md](CODE_OF_CONDUCT.zh-CN.md)
+
+## Our Pledge
+
+We as contributors and maintainers pledge to make participation in the `frontend-craft` community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socioeconomic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Using welcoming and inclusive language.
+- Being respectful of differing viewpoints and experiences.
+- Giving and gracefully accepting constructive feedback.
+- Focusing on what is best for the community.
+- Showing empathy toward other community members.
+
+Examples of unacceptable behavior:
+
+- Harassment, intimidation, or discriminatory language.
+- Trolling, insulting comments, or personal attacks.
+- Publishing others' private information without explicit permission.
+- Public or private conduct that would reasonably be considered inappropriate in a professional setting.
+
+## Enforcement
+
+Maintainers are responsible for clarifying and enforcing standards of acceptable behavior. They may remove, edit, or reject comments, commits, issues, pull requests, and other contributions that do not align with this Code of Conduct.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the maintainer listed in `package.json`. Reports will be reviewed and investigated as promptly and fairly as possible.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.