@bovinphang/frontend-craft 2.8.0 → 2.9.0

package/docs/project-structure.md

@@ -1,131 +1,151 @@
-# Project Structure
-
-Detailed directory layout for `frontend-craft`.
-
-## Repository Layout
-
-```text
-frontend-craft/
-|-- .claude-plugin/   # Claude Code plugin + marketplace manifests
-|   |-- plugin.json         # Plugin metadata
-|   |-- marketplace.json    # Marketplace directory metadata
-|
-|-- agents/           # Specialized sub-agents for delegation
-|   |-- fec-architect.md    # Page splitting, component architecture, state flow
-|   |-- fec-code-reviewer.md # Frontend-focused code review (quality, security, a11y)
-|   |-- fec-security-reviewer.md # Frontend attack surface: XSS, secrets, CSP, deps
-|   |-- fec-test-planner.md # Testing strategy, risk matrix, coverage planning
-|   |-- fec-debugger.md # Complex build/runtime/UI/API diagnostics
-|   |-- fec-refactor-cleaner.md # Dead-code and unused dependency cleanup
-|   |-- fec-doc-updater.md # README/runtime docs/capability table synchronization
-|   |-- fec-e2e-runner.md     # E2E authoring, execution, flaky handling, artifacts, CI
-|   |-- fec-typescript-reviewer.md    # TS/JS type safety, async, security, report-only review
-|   |-- fec-performance-optimizer.md # Performance bottleneck analysis and optimization
-|   |-- fec-ui-checker.md            # UI visual issues, design fidelity evaluation
-|   |-- fec-figma-implementer.md     # Precise UI implementation from design
-|   |-- fec-design-token-mapper.md   # Map design variables to Design Tokens
-|
-|-- skills/           # Workflow definitions and domain knowledge
-|   |-- fec-code-review/    # Architecture, types, rendering, styles, a11y
-|   |-- fec-security-review/     # XSS, CSRF, sensitive data, input validation
-|   |-- fec-accessibility-check/     # WCAG 2.2 accessibility, keyboard, focus, screen readers
-|   |-- fec-code-review/    # Architecture, types, rendering, styles, a11y
-|   |-- fec-security-review/     # XSS, CSRF, sensitive data, input validation
-|   |-- fec-accessibility-check/     # WCAG 2.2 accessibility, keyboard, focus, screen readers
-|   |-- fec-react-project-standard/  # React + TypeScript project standards
-|   |-- fec-vue3-project-standard/   # Vue 3 + TypeScript project standards
-|   |-- fec-implement-from-design/   # Implement UI from design tools, screenshots, and visual references
-|   |-- fec-validation-fix/            # lint, type-check, test, build and fix
-|   |-- fec-performance-optimization/  # Core Web Vitals, bundle, rendering, network, memory
-|   |-- fec-source-driven-development/ # Official sources, project facts, version-sensitive decisions
-|   |-- fec-typescript-project-standard/   # TypeScript config, public API types, declarations, DTOs, generics
-|   |-- fec-state-management/         # State ownership, store selection, URL/server/form/local boundaries
-|   |-- fec-tailwind-design-system/   # Tailwind tokens, variants, dark mode, class governance
-|   |-- fec-responsive-layout/        # Mobile-first layouts, container queries, touch-safe responsive UI
-|   |-- fec-dependency-upgrade/       # Dependency upgrades, lockfile risk, CVE remediation
-|   |-- fec-tdd-workflow/              # Test-first frontend implementation workflow
-|   |-- fec-refactor-clean/            # Safe dead-code and unused dependency cleanup
-|   |-- fec-doc-sync/                  # Public docs and metadata synchronization
-|   |-- fec-legacy-web-standard/     # JS + jQuery + HTML legacy project standards
-|   |-- fec-legacy-to-modern-migration/ # jQuery/MPA migration to React/Vue strategy and workflow
-|   |-- fec-testing-strategy/          # Testing layer selection and coverage matrix
-|   |-- fec-e2e-testing/                # Playwright/Cypress E2E testing standards
-|   |-- fec-component-testing/          # RTL / Vue Test Utils component tests
-|   |-- fec-debug-framework/            # Unified 5-step diagnostic framework for build/runtime/UI/API failures
-|   |-- fec-nextjs-project-standard/    # Next.js 14+ App Router, SSR/SSG standards
-|   |-- fec-nuxt-project-standard/      # Nuxt 3 SSR/SSG, composables standards
-|   |-- fec-monorepo-project-standard/  # pnpm workspace, Turborepo, Nx standards
-|   |-- fec-vite-project-standard/      # Vite config, env safety, HMR, proxy, build and library mode
-|   |-- fec-data-fetching/              # TanStack Query and server-state workflows
-|   |-- fec-api-integration/            # Typed API clients, auth refresh, uploads, realtime integration
-|   |-- fec-backend-requirements-handoff/ # Frontend-to-backend UI data and state needs
-|   |-- fec-form-handling/              # React Hook Form + Zod form workflows
-|   |-- fec-route-protection/           # Authenticated and permissioned routes
-|   |-- fec-pwa-implementation/         # PWA manifest, service worker, offline
-|   |-- fec-web-workers/                # Worker integration and background compute
-|   |-- fec-canvas-threejs/             # Canvas, Three.js, React Three Fiber
-|   |-- fec-svg-animation/              # SVG motion and reduced-motion fallbacks
-|   |-- fec-browser-storage/            # localStorage/sessionStorage/IndexedDB/Cookies selection and safe client persistence
-|   |-- fec-list-virtualization/        # Large-list windowing with react-window / TanStack Virtual and measurement strategies
-|   |-- fec-storybook-component-doc/    # Storybook component docs, addons, MDX, interaction and visual test integration
-|   |-- fec-ui-design/                  # Product-context UI direction, design dials, media strategy, visual QA
-|   |-- fec-image-generation/           # Diagram/image generation, editing workflows, PNG QA and repair loops
-|   |-- fec-drawio-studio/              # Editable draw.io diagrams, shape lookup, auto-layout, code structure maps
-|   |-- fec-web-video-presentation/     # Recordable 16:9 step-driven web video presentations
-|   |-- fec-motion-interaction/         # Context-aware motion intensity, transitions, scroll animation, reduced motion
-|   |-- fec-alchemy/                    # Project absorption workflow — extract reference ideas and redesign natively
-|
-|-- commands/         # Slash commands for quick execution
-|   |-- fec-init.md     # /fec-init - Initialize project templates
-|   |-- fec-review.md   # /fec-review - Code review
-|   |-- fec-scaffold.md # /fec-scaffold - Create page/feature/component
-|   |-- fec-plan.md     # /fec-plan - Implementation planning before frontend changes
-|   |-- fec-tdd.md      # /fec-tdd - Test-driven frontend implementation
-|   |-- fec-debug.md    # /fec-debug - Diagnose and fix frontend failures
-|   |-- fec-refactor-clean.md # /fec-refactor-clean - Safe dead-code cleanup
-|   |-- fec-doc-sync.md # /fec-doc-sync - Public docs and metadata sync
-|
-|-- hooks/            # Event-driven automation
-|   |-- hooks.json     # PreToolUse, PostToolUse, Stop, Notification, etc.
-|
-|-- src/              # TypeScript source for published runtime code
-|   |-- hooks/         # Runtime hook scripts bundled to dist/hooks
-|   |-- security-check.ts      # Block dangerous commands
-|   |-- format-changed-file.ts # Auto Prettier formatting
-|   |-- run-tests.ts           # Run checks on session end
-|   |-- session-start.ts       # Detect framework on session start
-|   |-- notify.ts              # Cross-platform desktop notifications
-|   |-- install/       # Installer core (CLI, interactive wizard, runtime converters)
-|   |-- openclaw/      # OpenClaw runtime TypeScript source
-|
-|-- scripts/          # Source-run repository maintenance scripts, not published to npm
-|
-|-- templates/        # Runtime-specific project templates
-|   |-- claude/        # CLAUDE.md and settings.json
-|   |-- codex/         # AGENTS.md and config.toml
-|   |-- cursor/        # Cursor runtime project stubs
-|   |-- gemini/        # Gemini CLI runtime project stubs
-|   |-- openclaw/      # AGENTS.md and OPENCLAW-CONFIG.md
-|   |-- windsurf/      # Windsurf runtime project stubs
-|   |-- shared/rules/  # 20 rule files: vue, react, rendering patterns, responsive design, testing, source-driven development, etc.
-|
-|-- .mcp.json         # MCP server config (Figma, Figma Desktop, Sketch, MasterGo, Pixso, 墨刀)
-└-- README.md
-```
-
-## Directory Responsibilities
-
-| Directory       | Purpose                                                                                                               |
-| --------------- | --------------------------------------------------------------------------------------------------------------------- |
-| `agents/`       | Specialized sub-agent definitions (Markdown + YAML frontmatter)                                                       |
-| `bin/`          | CLI entry point (`frontend-craft.ts`)                                                                                 |
-| `commands/`     | Custom slash commands (`fec-init`, `fec-review`, `fec-scaffold`, workflow commands)                                   |
-| `docs/`         | Runtime installation docs and localized READMEs                                                                       |
-| `hooks/`        | Hook configuration (`hooks.json`)                                                                                     |
-| `scripts/`      | Source-run maintenance scripts (build, packaging, publishing checks, metadata sync), excluded from npm runtime output |
-| `skills/`       | Skill definitions (`SKILL.md`, `metadata.json`)                                                                       |
-| `src/hooks/`    | Runtime hook source bundled into `dist/hooks/` for Claude/Qoder execution                                             |
-| `src/install/`  | Installer core (CLI, interactive wizard, runtime converters)                                                          |
-| `src/openclaw/` | OpenClaw runtime TypeScript source                                                                                    |
-| `templates/`    | Runtime-specific project templates (Claude/Codex/Cursor/Gemini/OpenClaw/Windsurf configs + shared rules)             |
-| `tests/`        | Test suite (converter tests, installer tests)                                                                         |
+# Project Structure
+
+Detailed directory layout for `frontend-craft`.
+
+## Repository Layout
+
+```text
+frontend-craft/
+|-- .claude-plugin/   # Claude Code plugin + marketplace manifests
+|   |-- plugin.json         # Plugin metadata
+|   |-- marketplace.json    # Marketplace directory metadata
+|
+|-- agents/           # Specialized sub-agents for delegation
+|   |-- fec-architect.md    # Page splitting, component architecture, state flow
+|   |-- fec-code-reviewer.md # Frontend-focused code review (quality, security, a11y)
+|   |-- fec-security-reviewer.md # Frontend attack surface: XSS, secrets, CSP, deps
+|   |-- fec-test-planner.md # Testing strategy, risk matrix, coverage planning
+|   |-- fec-debugger.md # Complex build/runtime/UI/API diagnostics
+|   |-- fec-refactor-cleaner.md # Dead-code and unused dependency cleanup
+|   |-- fec-refactoring-expert.md # Behavior-preserving smell diagnosis, planning, execution, validation
+|   |-- fec-doc-updater.md # README/runtime docs/capability table synchronization
+|   |-- fec-e2e-runner.md     # E2E authoring, execution, flaky handling, artifacts, CI
+|   |-- fec-typescript-reviewer.md    # TS/JS type safety, async, security, report-only review
+|   |-- fec-performance-optimizer.md # Performance bottleneck analysis and optimization
+|   |-- fec-ui-checker.md            # UI visual issues, design fidelity evaluation
+|   |-- fec-figma-implementer.md     # Precise UI implementation from design
+|   |-- fec-design-token-mapper.md   # Map design variables to Design Tokens
+|
+|-- skills/           # Workflow definitions and domain knowledge
+|   |-- fec-code-review/    # Architecture, types, rendering, styles, a11y
+|   |-- fec-security-review/     # XSS, CSRF, sensitive data, input validation
+|   |-- fec-accessibility-check/     # WCAG 2.2 accessibility, keyboard, focus, screen readers
+|   |-- fec-code-review/    # Architecture, types, rendering, styles, a11y
+|   |-- fec-security-review/     # XSS, CSRF, sensitive data, input validation
+|   |-- fec-accessibility-check/     # WCAG 2.2 accessibility, keyboard, focus, screen readers
+|   |-- fec-react-project-standard/  # React + TypeScript project standards
+|   |-- fec-vue3-project-standard/   # Vue 3 + TypeScript project standards
+|   |-- fec-implement-from-design/   # Implement UI from design tools, screenshots, and visual references
+|   |-- fec-validation-fix/            # lint, type-check, test, build and fix
+|   |-- fec-performance-optimization/  # Core Web Vitals, bundle, rendering, network, memory
+|   |-- fec-source-driven-development/ # Official sources, project facts, version-sensitive decisions
+|   |-- fec-typescript-project-standard/   # TypeScript config, public API types, declarations, DTOs, generics
+|   |-- fec-state-management/         # State ownership, store selection, URL/server/form/local boundaries
+|   |-- fec-tailwind-design-system/   # Tailwind tokens, variants, dark mode, class governance
+|   |-- fec-responsive-layout/        # Mobile-first layouts, container queries, touch-safe responsive UI
+|   |-- fec-dependency-upgrade/       # Dependency upgrades, lockfile risk, CVE remediation
+|   |-- fec-tdd-workflow/              # Test-first frontend implementation workflow
+|   |-- fec-refactor-clean/            # Safe dead-code and unused dependency cleanup
+|   |-- fec-refactoring/              # Core behavior-preserving refactoring workflow and safety gates
+|   |-- fec-code-smells/               # 24-smell evidence-based diagnosis
+|   |-- fec-refactoring-catalog/       # 61-technique selection and composition catalog
+|   |-- fec-refactoring-functions/     # Function family refactorings
+|   |-- fec-refactoring-encapsulation/ # Encapsulation family refactorings
+|   |-- fec-refactoring-move-features/ # Moving-feature family refactorings
+|   |-- fec-refactoring-data/          # Data family refactorings
+|   |-- fec-refactoring-control/       # Conditional/control family refactorings
+|   |-- fec-refactoring-api/           # API family refactorings
+|   |-- fec-refactoring-inheritance/   # Inheritance/delegation family refactorings
+|   |-- fec-refactoring-validation/    # Behavior-preservation validation and proof levels
+|   |-- fec-doc-sync/                  # Public docs and metadata synchronization
+|   |-- fec-legacy-web-standard/     # JS + jQuery + HTML legacy project standards
+|   |-- fec-legacy-to-modern-migration/ # jQuery/MPA migration to React/Vue strategy and workflow
+|   |-- fec-testing-strategy/          # Testing layer selection and coverage matrix
+|   |-- fec-e2e-testing/                # Playwright/Cypress E2E testing standards
+|   |-- fec-component-testing/          # RTL / Vue Test Utils component tests
+|   |-- fec-debug-framework/            # Unified 5-step diagnostic framework for build/runtime/UI/API failures
+|   |-- fec-nextjs-project-standard/    # Next.js 14+ App Router, SSR/SSG standards
+|   |-- fec-nuxt-project-standard/      # Nuxt 3 SSR/SSG, composables standards
+|   |-- fec-monorepo-project-standard/  # pnpm workspace, Turborepo, Nx standards
+|   |-- fec-vite-project-standard/      # Vite config, env safety, HMR, proxy, build and library mode
+|   |-- fec-data-fetching/              # TanStack Query and server-state workflows
+|   |-- fec-api-integration/            # Typed API clients, auth refresh, uploads, realtime integration
+|   |-- fec-backend-requirements-handoff/ # Frontend-to-backend UI data and state needs
+|   |-- fec-form-handling/              # React Hook Form + Zod form workflows
+|   |-- fec-route-protection/           # Authenticated and permissioned routes
+|   |-- fec-pwa-implementation/         # PWA manifest, service worker, offline
+|   |-- fec-web-workers/                # Worker integration and background compute
+|   |-- fec-canvas-threejs/             # Canvas, Three.js, React Three Fiber
+|   |-- fec-svg-animation/              # SVG motion and reduced-motion fallbacks
+|   |-- fec-browser-storage/            # localStorage/sessionStorage/IndexedDB/Cookies selection and safe client persistence
+|   |-- fec-list-virtualization/        # Large-list windowing with react-window / TanStack Virtual and measurement strategies
+|   |-- fec-storybook-component-doc/    # Storybook component docs, addons, MDX, interaction and visual test integration
+|   |-- fec-ui-design/                  # Product-context UI direction, design dials, media strategy, visual QA
+|   |-- fec-image-generation/           # Diagram/image generation, editing workflows, PNG QA and repair loops
+|   |-- fec-drawio-studio/              # Editable draw.io diagrams, shape lookup, auto-layout, code structure maps
+|   |-- fec-web-video-presentation/     # Recordable 16:9 step-driven web video presentations
+|   |-- fec-motion-interaction/         # Context-aware motion intensity, transitions, scroll animation, reduced motion
+|   |-- fec-alchemy/                    # Project absorption workflow — extract reference ideas and redesign natively
+|
+|-- commands/         # Slash commands for quick execution
+|   |-- fec-init.md     # /fec-init - Initialize project templates
+|   |-- fec-review.md   # /fec-review - Project by default; targeted scope or explicit changes
+|   |-- fec-scaffold.md # /fec-scaffold - Create page/feature/component
+|   |-- fec-plan.md     # /fec-plan - Implementation planning before frontend changes
+|   |-- fec-tdd.md      # /fec-tdd - Test-driven frontend implementation
+|   |-- fec-debug.md    # /fec-debug - Diagnose and fix frontend failures
+|   |-- fec-refactor-clean.md # /fec-refactor-clean - Safe dead-code cleanup
+|   |-- fec-smell.md          # /fec-smell - Read-only code-smell diagnosis
+|   |-- fec-refactor-plan.md  # /fec-refactor-plan - Read-only small-step refactoring plan
+|   |-- fec-refactor.md       # /fec-refactor - Controlled behavior-preserving execution
+|   |-- fec-doc-sync.md # /fec-doc-sync - Public docs and metadata sync
+|
+|-- hooks/            # Event-driven automation
+|   |-- hooks.json     # PreToolUse, PostToolUse, Stop, Notification, etc.
+|
+|-- src/              # TypeScript source for published runtime code
+|   |-- hooks/         # Runtime hook scripts bundled to dist/hooks
+|   |-- security-check.ts      # Block dangerous commands
+|   |-- format-changed-file.ts # Auto Prettier formatting
+|   |-- run-tests.ts           # Run checks on session end
+|   |-- session-start.ts       # Detect framework on session start
+|   |-- notify.ts              # Cross-platform desktop notifications
+|   |-- install/       # Installer core (CLI, interactive wizard, runtime converters)
+|   |-- openclaw/      # OpenClaw runtime TypeScript source
+|
+|-- scripts/          # Source-run repository maintenance scripts, not published to npm
+|
+|-- templates/        # Runtime-specific project templates
+|   |-- claude/        # CLAUDE.md and settings.json
+|   |-- codex/         # AGENTS.md and config.toml
+|   |-- cursor/        # Cursor runtime project stubs
+|   |-- gemini/        # Gemini CLI runtime project stubs
+|   |-- openclaw/      # AGENTS.md and OPENCLAW-CONFIG.md
+|   |-- windsurf/      # Windsurf runtime project stubs
+|   |-- shared/rules/  # 20 rule files: vue, react, rendering patterns, responsive design, testing, source-driven development, etc.
+|
+|-- .mcp.json         # MCP server config (Figma, Figma Desktop, Sketch, MasterGo, Pixso, 墨刀)
+└-- README.md
+```
+
+## Directory Responsibilities
+
+| Directory       | Purpose                                                                                                               |
+| --------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `agents/`       | Specialized sub-agent definitions (Markdown + YAML frontmatter)                                                       |
+| `bin/`          | CLI entry point (`frontend-craft.ts`)                                                                                 |
+| `commands/`     | Custom slash commands (`fec-init`, `fec-review`, `fec-scaffold`, workflow commands)                                   |
+| `docs/`         | Runtime installation docs and localized READMEs                                                                       |
+| `hooks/`        | Hook configuration (`hooks.json`)                                                                                     |
+| `scripts/`      | Source-run maintenance scripts (build, packaging, publishing checks, metadata sync), excluded from npm runtime output |
+| `skills/`       | Skill definitions (`SKILL.md`, `metadata.json`)                                                                       |
+| `src/hooks/`    | Runtime hook source bundled into `dist/hooks/` for Claude/Qoder execution                                             |
+| `src/install/`  | Installer core (CLI, interactive wizard, runtime converters)                                                          |
+| `src/openclaw/` | OpenClaw runtime TypeScript source                                                                                    |
+| `templates/`    | Runtime-specific project templates (Claude/Codex/Cursor/Gemini/OpenClaw/Windsurf configs + shared rules)             |
+| `tests/`        | Test suite (converter tests, installer tests)                                                                         |
+
+
+Technical diagram quality: `fec-image-generation` prefers local Mermaid for standard sequence/workflow diagrams and the draw.io workflow for editable architecture, with JSON/HTML fallback when tools are unavailable. Export a browser-measured manifest scaled to the PNG, run QA and inspect the final image. Preserve complete text, explicit layout and relationships; repair the source for at most two automatic rounds and report unresolved issues. Reproducible fixtures are in `skills/fec-image-generation/assets/quality-examples/`.
+
+[Review scope and technical diagram delivery](review-and-diagram-workflows.md) — scope, tool prerequisites, export commands, and QA limits.

package/docs/refactoring/README.md

@@ -0,0 +1,50 @@
+# frontend-craft 重构子系统
+
+本目录是重构子系统的人类导航入口。详细可执行知识位于 `skills/` 与 `localized/zh-CN/skills/`，这里不重复完整操作步骤。
+
+## 能力入口
+
+| 入口 | 模式 | 用途 |
+| --- | --- | --- |
+| `/fec-smell` | 只读诊断 | 基于证据识别代码坏味道，检查误判并给出候选重构手法 |
+| `/fec-refactor-plan` | 只读规划 | 把诊断结果组织为有依赖顺序、可验证、可回滚的小步重构计划 |
+| `/fec-refactor` | 受控执行 | 在保持既有可观察行为的前提下，一次执行一个主要重构并逐步验证 |
+
+## 核心安全模型
+
+纯重构遵循 `GREEN → REFACTOR → GREEN`：先记录可用的绿色基线，再做结构变化，再回到同一行为基线。新增行为或行为变化型缺陷修复仍属于 TDD 的 `RED → GREEN → REFACTOR`。
+
+风险统一分为：
+
+- `SAFE`：局部、私有、易回滚且验证充分；
+- `CAUTION`：跨模块、状态归属、组件边界或动态引用等需要额外证据；
+- `DANGER`：公开 API、路由、持久化、网络协议、权限、SSR/hydration、关键业务计算等高风险边界，默认先规划并明确确认。
+
+每个执行步骤还要记录**差异预算（Diff Budget）**：预期文件数、函数/组件数、公开 API 变化数和行为变化数。实际范围明显超出预算时停止并重新评估。
+
+## 与相邻工作流的边界
+
+- 已证明未使用的代码、导出、样式、路由或依赖：使用 `fec-refactor-clean`；
+- 新增行为或行为变化型 bug 修复：使用 `fec-tdd-workflow`；
+- 原因未知的构建、运行时、UI 或 API 故障：使用 `fec-debug-framework`；
+- 已知的 lint/typecheck/test/build 失败修复：使用 `fec-validation-fix`；
+- 改动合并就绪性、指定文件或目录、全项目代码审核：使用 `fec-code-review`；未限定时默认全项目，明确改动 / PR / 提交上下文时增量审核；明确指定范围时包括未改动代码，全项目审核按模块记录覆盖情况；
+- 框架、依赖、状态库迁移或大范围架构替换：进入对应 migration/architecture 工作流，而不是当作普通重构。
+
+## 知识范围
+
+本子系统覆盖：
+
+- 第 3 章的 24 种代码坏味道；
+- 第 6～12 章的 61 个标准重构手法；
+- 坏味道到候选手法的多对多关系；
+- 手法的前置条件、组合关系、风险和行为保持检查；
+- TypeScript、React、Vue、现代函数式/组合式前端的项目原生适配。
+
+查看 [61 项重构目录](catalog.md) 与 [坏味道—重构矩阵](smell-refactoring-matrix.md)。
+
+## 来源与内容转换原则
+
+知识基线来自用户提供的《重构：改善既有代码的设计（第 2 版）》JavaScript 版 Markdown/PDF，尤其是第 2～12 章、重构列表以及坏味道与重构手法速查材料。frontend-craft 保留标准术语、目录完整性和来源支持的关系，但不会复制长段正文或完整案例。
+
+`Frontend-Craft 前端适配`、AI Agent 风险门禁、差异预算、报告格式、React/Vue/TypeScript 示例等属于本项目重新编写的工程增强，用于把经典重构思想转换为可执行的前端智能体工作流。

package/docs/refactoring/catalog.md

@@ -0,0 +1,105 @@
+# 61 项标准重构目录
+
+本表用于快速导航。详细动机、前置条件、操作步骤、行为保持检查和前端适配请打开对应中文 Reference。
+
+## 函数组织（第 6 章） — 11 项
+
+| ID | 中文标准名 | 英文标准名 | 详细知识 |
+| --- | --- | --- | --- |
+| `RF-EXTRACT-FUNCTION` | 提炼函数 | Extract Function | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-INLINE-FUNCTION` | 内联函数 | Inline Function | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-EXTRACT-VARIABLE` | 提炼变量 | Extract Variable | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-INLINE-VARIABLE` | 内联变量 | Inline Variable | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-CHANGE-FUNCTION-DECLARATION` | 改变函数声明 | Change Function Declaration | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-ENCAPSULATE-VARIABLE` | 封装变量 | Encapsulate Variable | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-RENAME-VARIABLE` | 变量改名 | Rename Variable | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-INTRODUCE-PARAMETER-OBJECT` | 引入参数对象 | Introduce Parameter Object | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-COMBINE-FUNCTIONS-INTO-CLASS` | 函数组合成类 | Combine Functions into Class | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-COMBINE-FUNCTIONS-INTO-TRANSFORM` | 函数组合成变换 | Combine Functions into Transform | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-functions/references/function-refactorings.md) |
+| `RF-SPLIT-PHASE` | 拆分阶段 | Split Phase | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-functions/references/function-refactorings.md) |
+
+## 封装（第 7 章） — 9 项
+
+| ID | 中文标准名 | 英文标准名 | 详细知识 |
+| --- | --- | --- | --- |
+| `RF-ENCAPSULATE-RECORD` | 封装记录 | Encapsulate Record | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-ENCAPSULATE-COLLECTION` | 封装集合 | Encapsulate Collection | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-REPLACE-PRIMITIVE-WITH-OBJECT` | 以对象取代基本类型 | Replace Primitive with Object | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-REPLACE-TEMP-WITH-QUERY` | 以查询取代临时变量 | Replace Temp with Query | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-EXTRACT-CLASS` | 提炼类 | Extract Class | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-INLINE-CLASS` | 内联类 | Inline Class | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-HIDE-DELEGATE` | 隐藏委托关系 | Hide Delegate | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-REMOVE-MIDDLE-MAN` | 移除中间人 | Remove Middle Man | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+| `RF-SUBSTITUTE-ALGORITHM` | 替换算法 | Substitute Algorithm | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-encapsulation/references/encapsulation-refactorings.md) |
+
+## 搬移特性（第 8 章） — 9 项
+
+| ID | 中文标准名 | 英文标准名 | 详细知识 |
+| --- | --- | --- | --- |
+| `RF-MOVE-FUNCTION` | 搬移函数 | Move Function | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-MOVE-FIELD` | 搬移字段 | Move Field | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-MOVE-STATEMENTS-INTO-FUNCTION` | 搬移语句到函数 | Move Statements into Function | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-MOVE-STATEMENTS-TO-CALLERS` | 搬移语句到调用者 | Move Statements to Callers | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-REPLACE-INLINE-CODE-WITH-FUNCTION-CALL` | 以函数调用取代内联代码 | Replace Inline Code with Function Call | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-SLIDE-STATEMENTS` | 移动语句 | Slide Statements | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-SPLIT-LOOP` | 拆分循环 | Split Loop | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-REPLACE-LOOP-WITH-PIPELINE` | 以管道取代循环 | Replace Loop with Pipeline | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-move-features/references/moving-refactorings.md) |
+| `RF-REMOVE-DEAD-CODE` | 移除死代码 | Remove Dead Code | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-move-features/references/moving-refactorings.md) |
+
+## 重新组织数据（第 9 章） — 5 项
+
+| ID | 中文标准名 | 英文标准名 | 详细知识 |
+| --- | --- | --- | --- |
+| `RF-SPLIT-VARIABLE` | 拆分变量 | Split Variable | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-data/references/data-refactorings.md) |
+| `RF-RENAME-FIELD` | 字段改名 | Rename Field | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-data/references/data-refactorings.md) |
+| `RF-REPLACE-DERIVED-VARIABLE-WITH-QUERY` | 以查询取代派生变量 | Replace Derived Variable with Query | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-data/references/data-refactorings.md) |
+| `RF-CHANGE-REFERENCE-TO-VALUE` | 将引用对象改为值对象 | Change Reference to Value | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-data/references/data-refactorings.md) |
+| `RF-CHANGE-VALUE-TO-REFERENCE` | 将值对象改为引用对象 | Change Value to Reference | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-data/references/data-refactorings.md) |
+
+## 简化条件逻辑（第 10 章） — 6 项
+
+| ID | 中文标准名 | 英文标准名 | 详细知识 |
+| --- | --- | --- | --- |
+| `RF-DECOMPOSE-CONDITIONAL` | 分解条件表达式 | Decompose Conditional | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-control/references/conditional-refactorings.md) |
+| `RF-CONSOLIDATE-CONDITIONAL-EXPRESSION` | 合并条件表达式 | Consolidate Conditional Expression | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-control/references/conditional-refactorings.md) |
+| `RF-REPLACE-NESTED-CONDITIONAL-WITH-GUARD-CLAUSES` | 以卫语句取代嵌套条件表达式 | Replace Nested Conditional with Guard Clauses | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-control/references/conditional-refactorings.md) |
+| `RF-REPLACE-CONDITIONAL-WITH-POLYMORPHISM` | 以多态取代条件表达式 | Replace Conditional with Polymorphism | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-control/references/conditional-refactorings.md) |
+| `RF-INTRODUCE-SPECIAL-CASE` | 引入特例 | Introduce Special Case | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-control/references/conditional-refactorings.md) |
+| `RF-INTRODUCE-ASSERTION` | 引入断言 | Introduce Assertion | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-control/references/conditional-refactorings.md) |
+
+## 重构 API（第 11 章） — 10 项
+
+| ID | 中文标准名 | 英文标准名 | 详细知识 |
+| --- | --- | --- | --- |
+| `RF-SEPARATE-QUERY-FROM-MODIFIER` | 将查询函数和修改函数分离 | Separate Query from Modifier | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-api/references/api-refactorings.md) |
+| `RF-PARAMETERIZE-FUNCTION` | 函数参数化 | Parameterize Function | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REMOVE-FLAG-ARGUMENT` | 移除标记参数 | Remove Flag Argument | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-api/references/api-refactorings.md) |
+| `RF-PRESERVE-WHOLE-OBJECT` | 保持对象完整 | Preserve Whole Object | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REPLACE-PARAMETER-WITH-QUERY` | 以查询取代参数 | Replace Parameter with Query | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REPLACE-QUERY-WITH-PARAMETER` | 以参数取代查询 | Replace Query with Parameter | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REMOVE-SETTING-METHOD` | 移除设值函数 | Remove Setting Method | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REPLACE-CONSTRUCTOR-WITH-FACTORY-FUNCTION` | 以工厂函数取代构造函数 | Replace Constructor with Factory Function | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REPLACE-FUNCTION-WITH-COMMAND` | 以命令取代函数 | Replace Function with Command | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-api/references/api-refactorings.md) |
+| `RF-REPLACE-COMMAND-WITH-FUNCTION` | 以函数取代命令 | Replace Command with Function | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-api/references/api-refactorings.md) |
+
+## 处理继承关系（第 12 章） — 11 项
+
+| ID | 中文标准名 | 英文标准名 | 详细知识 |
+| --- | --- | --- | --- |
+| `RF-PULL-UP-METHOD` | 函数上移 | Pull Up Method | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-PULL-UP-FIELD` | 字段上移 | Pull Up Field | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-PULL-UP-CONSTRUCTOR-BODY` | 构造函数本体上移 | Pull Up Constructor Body | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-PUSH-DOWN-METHOD` | 函数下移 | Push Down Method | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-PUSH-DOWN-FIELD` | 字段下移 | Push Down Field | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-REPLACE-TYPE-CODE-WITH-SUBCLASSES` | 以子类取代类型码 | Replace Type Code with Subclasses | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-REMOVE-SUBCLASS` | 移除子类 | Remove Subclass | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-EXTRACT-SUPERCLASS` | 提炼超类 | Extract Superclass | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-COLLAPSE-HIERARCHY` | 折叠继承体系 | Collapse Hierarchy | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-REPLACE-SUBCLASS-WITH-DELEGATE` | 以委托取代子类 | Replace Subclass with Delegate | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+| `RF-REPLACE-SUPERCLASS-WITH-DELEGATE` | 以委托取代超类 | Replace Superclass with Delegate | [查看 Reference](../../localized/zh-CN/skills/fec-refactoring-inheritance/references/inheritance-refactorings.md) |
+
+## 完整性
+
+- 总计：**61** 项。
+- 分组数量：`11 / 9 / 9 / 5 / 6 / 10 / 11`。
+- `RF-REMOVE-DEAD-CODE` 保留在目录中保证知识完整，但实际死代码发现与删除路由到 `fec-refactor-clean`。

package/docs/refactoring/smell-refactoring-matrix.md

@@ -0,0 +1,41 @@
+# 24 种代码坏味道与重构手法速查矩阵
+
+本矩阵基于已归一化的第 3 章坏味道关系。候选手法不是机械映射；实际选择还必须检查成因、前置条件、风险、行为契约和差异预算。
+
+| 坏味道 | 主要/辅助候选 | 选择提示 |
+| --- | --- | --- |
+| `SMELL-MYSTERIOUS-NAME`<br>神秘命名（Mysterious Name） | `RF-CHANGE-FUNCTION-DECLARATION`<br>`RF-RENAME-VARIABLE`<br>`RF-RENAME-FIELD` | 先确认“神秘命名”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-DUPLICATED-CODE`<br>重复代码（Duplicated Code） | `RF-EXTRACT-FUNCTION`<br>`RF-SLIDE-STATEMENTS`<br>`RF-PULL-UP-METHOD` | 先确认“重复代码”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-LONG-FUNCTION`<br>过长函数（Long Function） | `RF-EXTRACT-FUNCTION`<br>`RF-REPLACE-TEMP-WITH-QUERY`<br>`RF-INTRODUCE-PARAMETER-OBJECT`<br>`RF-PRESERVE-WHOLE-OBJECT`<br>`RF-REPLACE-FUNCTION-WITH-COMMAND`<br>`RF-DECOMPOSE-CONDITIONAL`<br>`RF-REPLACE-CONDITIONAL-WITH-POLYMORPHISM`<br>`RF-SPLIT-LOOP` | 先确认“过长函数”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-LONG-PARAMETER-LIST`<br>过长参数列表（Long Parameter List） | `RF-REPLACE-PARAMETER-WITH-QUERY`<br>`RF-PRESERVE-WHOLE-OBJECT`<br>`RF-INTRODUCE-PARAMETER-OBJECT`<br>`RF-REMOVE-FLAG-ARGUMENT`<br>`RF-COMBINE-FUNCTIONS-INTO-CLASS` | 先确认“过长参数列表”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-GLOBAL-DATA`<br>全局数据（Global Data） | `RF-ENCAPSULATE-VARIABLE` | 先确认“全局数据”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-MUTABLE-DATA`<br>可变数据（Mutable Data） | `RF-ENCAPSULATE-VARIABLE`<br>`RF-SPLIT-VARIABLE`<br>`RF-SLIDE-STATEMENTS`<br>`RF-EXTRACT-FUNCTION`<br>`RF-SEPARATE-QUERY-FROM-MODIFIER`<br>`RF-REMOVE-SETTING-METHOD`<br>`RF-REPLACE-DERIVED-VARIABLE-WITH-QUERY`<br>`RF-COMBINE-FUNCTIONS-INTO-CLASS`<br>`RF-COMBINE-FUNCTIONS-INTO-TRANSFORM`<br>`RF-CHANGE-REFERENCE-TO-VALUE` | 先确认“可变数据”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-DIVERGENT-CHANGE`<br>发散式变化（Divergent Change） | `RF-SPLIT-PHASE`<br>`RF-MOVE-FUNCTION`<br>`RF-EXTRACT-FUNCTION`<br>`RF-EXTRACT-CLASS` | 先确认“发散式变化”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-SHOTGUN-SURGERY`<br>霰弹式修改（Shotgun Surgery） | `RF-MOVE-FUNCTION`<br>`RF-MOVE-FIELD`<br>`RF-COMBINE-FUNCTIONS-INTO-CLASS`<br>`RF-COMBINE-FUNCTIONS-INTO-TRANSFORM`<br>`RF-SPLIT-PHASE`<br>`RF-INLINE-FUNCTION`<br>`RF-INLINE-CLASS` | 先确认“霰弹式修改”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-FEATURE-ENVY`<br>依恋情结（Feature Envy） | `RF-MOVE-FUNCTION`<br>`RF-EXTRACT-FUNCTION` | 先确认“依恋情结”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-DATA-CLUMPS`<br>数据泥团（Data Clumps） | `RF-EXTRACT-CLASS`<br>`RF-INTRODUCE-PARAMETER-OBJECT`<br>`RF-PRESERVE-WHOLE-OBJECT` | 先确认“数据泥团”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-PRIMITIVE-OBSESSION`<br>基本类型偏执（Primitive Obsession） | `RF-REPLACE-PRIMITIVE-WITH-OBJECT`<br>`RF-REPLACE-TYPE-CODE-WITH-SUBCLASSES`<br>`RF-REPLACE-CONDITIONAL-WITH-POLYMORPHISM`<br>`RF-EXTRACT-CLASS`<br>`RF-INTRODUCE-PARAMETER-OBJECT` | 先确认“基本类型偏执”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-REPEATED-SWITCHES`<br>重复的 switch（Repeated Switches） | `RF-REPLACE-CONDITIONAL-WITH-POLYMORPHISM` | 先确认“重复的 switch”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-LOOPS`<br>循环语句（Loops） | `RF-REPLACE-LOOP-WITH-PIPELINE` | 先确认“循环语句”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-LAZY-ELEMENT`<br>冗赘的元素（Lazy Element） | `RF-INLINE-FUNCTION`<br>`RF-INLINE-CLASS`<br>`RF-COLLAPSE-HIERARCHY` | 先确认“冗赘的元素”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-SPECULATIVE-GENERALITY`<br>夸夸其谈通用性（Speculative Generality） | `RF-COLLAPSE-HIERARCHY`<br>`RF-INLINE-FUNCTION`<br>`RF-INLINE-CLASS`<br>`RF-CHANGE-FUNCTION-DECLARATION`<br>`RF-REMOVE-DEAD-CODE` | 先确认“夸夸其谈通用性”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-TEMPORARY-FIELD`<br>临时字段（Temporary Field） | `RF-EXTRACT-CLASS`<br>`RF-MOVE-FUNCTION`<br>`RF-INTRODUCE-SPECIAL-CASE` | 先确认“临时字段”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-MESSAGE-CHAINS`<br>过长的消息链（Message Chains） | `RF-HIDE-DELEGATE`<br>`RF-EXTRACT-FUNCTION`<br>`RF-MOVE-FUNCTION` | 先确认“过长的消息链”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-MIDDLE-MAN`<br>中间人（Middle Man） | `RF-REMOVE-MIDDLE-MAN`<br>`RF-INLINE-FUNCTION`<br>`RF-REPLACE-SUPERCLASS-WITH-DELEGATE`<br>`RF-REPLACE-SUBCLASS-WITH-DELEGATE` | 先确认“中间人”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-INSIDER-TRADING`<br>内幕交易（Insider Trading） | `RF-MOVE-FUNCTION`<br>`RF-MOVE-FIELD`<br>`RF-HIDE-DELEGATE`<br>`RF-REPLACE-SUBCLASS-WITH-DELEGATE`<br>`RF-REPLACE-SUPERCLASS-WITH-DELEGATE` | 先确认“内幕交易”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-LARGE-CLASS`<br>过大的类（Large Class） | `RF-EXTRACT-CLASS`<br>`RF-EXTRACT-SUPERCLASS`<br>`RF-REPLACE-TYPE-CODE-WITH-SUBCLASSES` | 先确认“过大的类”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-ALTERNATIVE-CLASSES-DIFFERENT-INTERFACES`<br>异曲同工的类（Alternative Classes with Different Interfaces） | `RF-CHANGE-FUNCTION-DECLARATION`<br>`RF-MOVE-FUNCTION`<br>`RF-EXTRACT-SUPERCLASS` | 先确认“异曲同工的类”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-DATA-CLASS`<br>纯数据类（Data Class） | `RF-ENCAPSULATE-RECORD`<br>`RF-REMOVE-SETTING-METHOD`<br>`RF-MOVE-FUNCTION`<br>`RF-EXTRACT-FUNCTION`<br>`RF-SPLIT-PHASE` | 先确认“纯数据类”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-REFUSED-BEQUEST`<br>被拒绝的遗赠（Refused Bequest） | `RF-PUSH-DOWN-METHOD`<br>`RF-PUSH-DOWN-FIELD`<br>`RF-REPLACE-SUBCLASS-WITH-DELEGATE`<br>`RF-REPLACE-SUPERCLASS-WITH-DELEGATE` | 先确认“被拒绝的遗赠”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+| `SMELL-COMMENTS`<br>注释（Comments） | `RF-EXTRACT-FUNCTION`<br>`RF-CHANGE-FUNCTION-DECLARATION`<br>`RF-INTRODUCE-ASSERTION` | 先确认“注释”的真实成因，再从符合当前数据所有权、行为契约和前置条件的手法中选择最小安全变化。 |
+
+## 误判保护
+
+- 行数本身不能证明“过长函数”或“过大的类”；
+- 单个 `switch` 不能证明“重复的 switch”；
+- `filter().map().reduce()` 之类数据管道不自动等同于“过长的消息链”；
+- 注释本身不是缺陷，不能仅因 `Comments` 是坏味道类别就删除注释；
+- 不可变 DTO/中转数据可以合理保持为数据型结构；
+- React/Vue 声明式组合不自动等同于“中间人”或“过长的消息链”。
+
+详细诊断规则见 [`fec-code-smells`](../../localized/zh-CN/skills/fec-code-smells/references/detection-guide.md)。

package/docs/review-and-diagram-workflows.md

@@ -0,0 +1,39 @@
+# Review scope and technical diagram delivery
+
+These conventions apply to the installed capabilities across runtimes. Use natural-language requests; review modes are not installer CLI flags.
+
+## Review scope
+
+`fec-code-reviewer`, `fec-typescript-reviewer`, `fec-security-reviewer`, `fec-code-review`, `fec-security-review`, and `/fec-review` follow the same scope rules:
+
+| Request | Scope | Report conclusion |
+| --- | --- | --- |
+| No scope, including bare `/fec-review` | Entire project, even when Git changes exist | Risk assessment |
+| A file or directory | All existing code in that scope, including unchanged code | Scope risk assessment |
+| Explicit recent changes, PR, or commit | Requested diff and necessary context | Merge recommendation |
+
+Full and targeted reviews do not require a Git diff. An explicit incremental review with no changes reports that fact without expanding its scope. Reviewers keep their frontend, TypeScript, or security specialty; this does not certify a backend security audit.
+
+For project reviews, inventory owned frontend code, related tests, configuration, and dependency declarations, then review modules in batches. Exclude dependencies, generated files, build outputs, caches, and third-party code by default. Reports record mode, target scope, reviewed scope, exclusions, uncovered modules, and validation results. Mark incomplete reviews as partial and merge findings with the same root cause. Reading callers or running static checks does not count as manually reviewing those files. Report only unless fixes are explicitly requested.
+
+Examples: “Review the project”; “Review all code in `src/features/`”; “Review `src/components/Button.tsx`”; “Review only the recent changes.” Automatic review after edits must explicitly pass the current change scope.
+
+## Technical diagrams
+
+Use `fec-image-generation` for sequence diagrams and workflows with local Mermaid where available; use `fec-drawio-studio` for editable architecture diagrams. Use the JSON/HTML renderer when these tools are unavailable. Keep technical relationships and labels in editable source rather than relying on raster image generation for exact structure.
+
+The Mermaid adapter uses an installed CLI only; it does not download packages. PNG export requires a local Chromium browser, with `FEC_BROWSER_PATH` available for an explicit executable. Missing tools must be reported rather than claimed as successful exports.
+
+For the JSON/HTML route, render the source, export PNG with a browser-measured manifest at the same scale, run QA, and inspect the final image:
+
+```bash
+node skills/fec-image-generation/scripts/tech-diagram-render.mjs --input skills/fec-image-generation/assets/quality-examples/workflow.json --type workflow --output workflow.html --manifest workflow.layout.json
+node skills/fec-image-generation/scripts/export-diagram.mjs --input workflow.html --format png --output workflow.png --theme light --scale 2 --manifest workflow.layout.json --output-manifest workflow.actual.json
+node skills/fec-image-generation/scripts/png-qa.mjs --png workflow.png --manifest workflow.actual.json --format json
+```
+
+Preserve complete Unicode labels, explicit geometry, edge direction, sequence order, and self calls. Keep exported SVG styles self-contained. Geometry QA and browser measurement support visual inspection; neither proves semantic correctness nor completes a human visual review. Missing measurements or partial coverage must be disclosed. Repair the editable source for at most two automatic rounds, then report unresolved defects.
+
+Deliver editable source, the requested export, and QA/coverage results. See [reproducible examples](../skills/fec-image-generation/assets/quality-examples/README.md), [diagram workflows](../skills/fec-image-generation/references/diagram-workflows.md), and [PNG QA](../skills/fec-image-generation/references/png-qa-autofix.md).
+
+[简体中文](zh-CN/review-and-diagram-workflows.md)