---
name: elementor-site-initialize
description: Initialize a local custom Elementor Widget plugin, design handoff workspace, and pending site-style context, choosing a Flat or Grouped plugin structure from expected Widget scale. Use once before the first custom Widget when no plugin scaffold exists; theme context is optional and read-only. Do not map Elementor Site Settings, design visuals, implement Widgets, deploy, or inspect a live WordPress installation.
---

# Elementor Site Initialize

初始化自定义 Elementor Widget 的本地开发基础。默认 Elementor 已安装；插件源代码可以放在用户确认的任意本地路径，正式使用时再把完整插件目录放入 WordPress `wp-content/plugins/`。

## 执行

1. 把当前目录视为项目工作区，不向上寻找 WordPress 根目录。主题上下文只用于插件命名和技术集成事实；不尝试从本地主题文件推断 Elementor Site Settings 或视觉冲突。
2. 读取 [初始化契约](references/initialization-contract.md)，推导插件命名、目标路径、预计 Widget 规模、`Flat / Grouped` 结构、Site Mode 与 Style Authority。
3. 在写文件前展示一张确认卡。用户必须确认本地路径、结构 Profile、Site Mode 和 Style Authority；Grouped 还必须确认业务分组。用户可修改任意值。
4. 确认后创建项目配置、设计交接目录和所选插件骨架；只有主题技术上下文确有复用价值时才创建只读摘要。
5. 目标插件或配置已存在时先检查并保留，不覆盖、不重建，也不借初始化迁移 Flat/Grouped 结构。
6. 核对 PHP、JSON、目录和配置一致性，返回创建清单、结构决策和可选主题技术摘要；然后返回调用它的总控或原始任务，根据原始目标继续。

## 默认产物

- `elementor-project.json`
- `docs/elementor/theme-profile.md`（仅存在主题证据时）
- `docs/design-system/`
- `设计稿/modules/` 与 `设计稿/pages/`
- 用户确认路径下可被 `elementor-widget-pipeline` 扩展的 Flat 或 Grouped 插件骨架，包含项目专属 Elementor 分类与编辑器角标资产

空目录只需在本地创建，不添加装饰性占位文档。Design System 未建立时只标记 `pending`，不要替用户设计。

## 边界

- 不扫描 WordPress 根目录，不检查或安装 Elementor。
- 不初始化 CSS/JS 构建工具，默认原生 PHP、CSS、JS。
- 可选主题读取始终只读，只服务于命名和技术集成；不扫描或预判视觉冲突，不修改 `functions.php`、主题资源或线上 `wp-content/plugins/`。
- 不创建 Design System、HTML 设计稿或具体 Widget。
- 不生成 Elementor Style Contract；初始化只在项目配置中记录 `siteStyle.status: pending`，正式映射交给 `elementor-site-style-adapter`。
- 不自动把现有 Flat 插件迁移为 Grouped，也不根据后续文件数量偷偷换结构。
- 不固定推荐 Design System。完成后返回 `elementor-site-team-manager` 或原始任务：已有确认版设计稿与 Confirmed Style Contract 时可直接进入 `elementor-widget-pipeline`；需要视觉规则时进入 `website-design-system-architect`；已有 Design System 但缺 Elementor 映射时进入 `elementor-site-style-adapter`；其他情况由现有依赖决定。