Communitygithub.com

supersite-build

面向AI编码代理的外科手术式网站构建工具。读取 supersite-plan.md 规范合同,生成简洁可组合的 React/Next.js 组件,串联设计令牌,并通过 npm run build 验证编译。

supersite-build 是什么?

supersite-build 是一个为 AI 编码代理(如 Claude Code、Cursor、Codex 等)设计的外科手术式网站构建工具。它读取由 supersite-plan 生成的规范文件 supersite-plan.md,并严格按照该规划执行构建。该工具的工作流程分为五个明确步骤:首先,验证并解析规划文件中的美学风格、颜色体系、排版、组件清单等内容;其次,搭建项目脚手架,包括 TypeScript 类型定义、集中配置文件和基础 CSS;接着,构建可复用的 UI 基元组件,如容器、按钮、卡片等;然后,根据规划构建各个区块级组件,如导航栏、Hero 区、功能网格、定价矩阵、FAQ 等;最后,组装页面路由,执行反AI幻觉审计(禁止使用紫色渐变、占位文案和 em-dash 破折号),并通过 npm run build 确保编译无错误。这个技能的主要价值在于它将网站构建过程高度结构化、可重复和可验证,减少了 AI 代理生成不一致或难以构建代码的可能性,特别适用于需要快速生成高质量、符合设计规范的网站的场景。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/developer-mohanaditya/supersite/tree/HEAD/skills/supersite-build

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

🔨 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

  1. 在工作区根目录寻找 supersite-plan.md。
    • 如果找不到,暂停并告知用户:

      "未在项目根目录找到 supersite-plan.md。请运行 /supersite-plan 来协作设计您的规划,或直接运行 /supersite <prompt> 直接生成。"

  2. 从规划中解析架构参数:
    • 美学风格与颜色调色板(Hex/OKLCH,60-30-10 分布)。
    • 字体排版和圆角选择。
    • 路由和组件清单。
    • 区块文案、标题和交互元素。

步骤 2:脚手架、类型和配置

  1. 验证依赖:
    • 确保标准工具库已安装(lucide-react、clsx、tailwind-merge)。如果缺失则安装:
      npm install lucide-react clsx tailwind-merge
      
  2. 生成 TypeScript 合同(src/types/site.ts):
    • 定义 NavItem、FeatureItem、PricingPlan、Testimonial 和 FAQItem 的类型。
  3. 生成集中配置(src/config/site.ts):
    • 将导航链接、品牌元数据和结构化区块内容统一存储在一个地方。
  4. 更新基础 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:组装路由并验证构建

  1. 组装 src/app/page.tsx:
    • 导入区块组件,并以清晰、声明式的 JSX 编排叙述布局。
  2. 组装其他路由:
    • 如果规划指定了多页面路由(/features、/pricing、/security),则构造相应的 page.tsx 文件。
  3. 执行预启动反AI幻觉审计:
    • 检查禁止使用的样式:无紫色渐变模糊块、无悬空卡片、无通用占位文案。
    • 检查触摸目标:验证交互点击区域是否 ≥44×44px。
    • 检查 em-dash 破折号:验证所有 UI 文案、标题、微文案和按钮标签中均无 em-dash(— 或 --)。
  4. 编译与构建关卡:
    • 执行工作区构建命令:
      npm run build
      
    • 如果出现任何 TypeScript 错误或缺少导入,立即修复并重新运行,直到构建以代码 0 干净通过。
  5. 向用户报告:
    • 在所有对话响应和进度报告中,严格执行零破折号规则(绝不使用 — 或 --)。改用句号、冒号、逗号或括号。
    • 提供已构建文件的清晰摘要及可点击链接:
      • [supersite-plan.md](file:///path/to/supersite-plan.md)
      • [page.tsx](file:///path/to/src/app/page.tsx)
      • src/components/site/ 中各个组件的链接
    • 确认编译成功。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能