🔨 supersite-build:外科手术式构建器
supersite-build 执行由 /supersite-plan 制定的架构规划。它读取 supersite-plan.md,构建原子级组件,串联设计令牌和文案,并针对构建引擎验证实现。
执行流程
┌─────────────────────────────────────────────────────────────┐
│ 1. 读取并验证规范合同 │
│ 从 supersite-plan.md 解析令牌、路由和清单 │
├─────────────────────────────────────────────────────────────┤
│ 2. 脚手架、类型和配置 │
│ 创建 src/types/site.ts、src/config/site.ts 及基础 CSS │
├─────────────────────────────────────────────────────────────┤
│ 3. 构建 UI 基元 │
│ 容器、SectionHeader、按钮、Badge 和卡片 │
├─────────────────────────────────────────────────────────────┤
│ 4. 构建区块组件 │
│ 导航栏、Hero、对比、功能、证明、定价和页脚 │
├─────────────────────────────────────────────────────────────┤
│ 5. 组装路由并验证构建 │
│ 编排页面,检查可访问性并执行 npm run build │
└─────────────────────────────────────────────────────────────┘
步骤 1:读取并验证 supersite-plan.md
- 在工作区根目录寻找
supersite-plan.md。- 如果找不到,暂停并告知用户:
"未在项目根目录找到
supersite-plan.md。请运行/supersite-plan来协作设计您的规划,或直接运行/supersite <prompt>直接生成。"
- 如果找不到,暂停并告知用户:
- 从规划中解析架构参数:
- 美学风格与颜色调色板(Hex/OKLCH,60-30-10 分布)。
- 字体排版和圆角选择。
- 路由和组件清单。
- 区块文案、标题和交互元素。
步骤 2:脚手架、类型和配置
- 验证依赖:
- 确保标准工具库已安装(
lucide-react、clsx、tailwind-merge)。如果缺失则安装:npm install lucide-react clsx tailwind-merge
- 确保标准工具库已安装(
- 生成 TypeScript 合同(
src/types/site.ts):- 定义
NavItem、FeatureItem、PricingPlan、Testimonial和FAQItem的类型。
- 定义
- 生成集中配置(
src/config/site.ts):- 将导航链接、品牌元数据和结构化区块内容统一存储在一个地方。
- 更新基础 CSS(
src/app/globals.css):- 注入颜色变量、选中样式和减少运动的可访问性代码块:
@layer base { ::selection { background-color: var(--accent); color: var(--accent-foreground); } } @media (prefers-reduced-motion: reduce) { *, ::before, ::after { animation-duration: 0.01ms !important; animation-iteration-count: 1 !important; transition-duration: 0.01ms !important; scroll-behavior: auto !important; } }
- 注入颜色变量、选中样式和减少运动的可访问性代码块:
步骤 3:构建 UI 基元(src/components/ui/)
生成模块化基元:
container.tsx:最大宽度容器(max-w-6xl或max-w-7xl)并带有响应式内边距。section-header.tsx:标准化的徽章、标题和描述区块。button.tsx:变体驱动的按钮(primary、secondary、outline、ghost)并带有显式的:focus-visible样式。badge.tsx:药丸形和状态标签,带有精致细线边框。card.tsx:表面封装器,应用规划中的表面颜色、边框和圆角令牌。
步骤 4:构建区块组件(src/components/site/)
构建规划中指定的每个区块:
navbar.tsx:响应式头部,包含桌面导航链接、操作 CTA 和移动端汉堡菜单抽屉。hero.tsx:钩子标签、H1 标题、引导段落、CTA 按钮组和交互式产品预览(例如终端或 UI 框架)。problem-contrast.tsx:不对称视觉对比,展示现状痛点与现代解决方案。feature-grid.tsx:不对称的便当网格或模块化功能单元。没有重复的 3 卡片复制。product-showcase.tsx:交互式组件(标签式代码浏览器、实时交互预览或配置沙盒)。social-proof.tsx:可验证的指标标注和客户推荐引用,包含具体工程角色。pricing-matrix.tsx:月度/年度计费切换(使用"use client")、层级卡片、功能清单和结账 CTA。faq-accordion.tsx:可展开的技术问答,使用平滑的 CSS 网格高度过渡。footer.tsx:多列导航链接、法律锚点、系统状态指示灯和版权信息。
步骤 5:组装路由并验证构建
- 组装
src/app/page.tsx:- 导入区块组件,并以清晰、声明式的 JSX 编排叙述布局。
- 组装其他路由:
- 如果规划指定了多页面路由(
/features、/pricing、/security),则构造相应的page.tsx文件。
- 如果规划指定了多页面路由(
- 执行预启动反AI幻觉审计:
- 检查禁止使用的样式:无紫色渐变模糊块、无悬空卡片、无通用占位文案。
- 检查触摸目标:验证交互点击区域是否 ≥44×44px。
- 检查 em-dash 破折号:验证所有 UI 文案、标题、微文案和按钮标签中均无 em-dash(
—或--)。
- 编译与构建关卡:
- 执行工作区构建命令:
npm run build - 如果出现任何 TypeScript 错误或缺少导入,立即修复并重新运行,直到构建以代码 0 干净通过。
- 执行工作区构建命令:
- 向用户报告:
- 在所有对话响应和进度报告中,严格执行零破折号规则(绝不使用
—或--)。改用句号、冒号、逗号或括号。 - 提供已构建文件的清晰摘要及可点击链接:
[supersite-plan.md](file:///path/to/supersite-plan.md)[page.tsx](file:///path/to/src/app/page.tsx)src/components/site/中各个组件的链接
- 确认编译成功。
- 在所有对话响应和进度报告中,严格执行零破折号规则(绝不使用