Communitygithub.com

supersite-plan

AI编码智能体的协作式网站架构师。通过结构化前沿访谈、选项与自定义用户指令,设计网站叙事与美学,并输出完整的 supersite-plan.md 规格说明书。

supersite-plan 是什么?

supersite-plan 是一个专注于网站规划的 AI 智能体技能,旨在编写代码前彻底规划网站架构。它避免了因期望不一致导致的返工:通过多维度前沿发现访谈(涵盖站点范围、美学风格、核心能力及代码库关系)收集用户需求,并与用户共创设计系统(如 60-30-10 色彩体系、字体、材质)。该技能会自动生成完整的项目合约文件 supersite-plan.md,其中包含设计令牌、路线层级、逐个区块的组件清单以及验证标准。它支持 Claude Code、Cursor 等主流 AI 代理平台,用户确认计划后,只需执行配套命令 /supersite-build 即可启动实际构建。其核心价值在于将创意决策与代码生成解耦,确保最终输出严格符合用户预期。

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

在你喜欢的 AI 中提问

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

文档

📐 supersite-plan:协作式架构师

supersite-plan 在编写代码之前规划网站。它通过进行聚焦访谈、建立设计系统、起草叙事序列并生成完整的 supersite-plan.md 项目合约,防止期望错位。

计划确认后,用户只需运行 /supersite-build 即可执行。


协作式规划流程

┌─────────────────────────────────────────────────────────────┐
│ 1. 多维度发现访谈                                            │
│ 提出结构化前沿问题(选项 + 自定义提示)                         │
├─────────────────────────────────────────────────────────────┤
│ 2. 设计令牌与类型综合                                        │
│ 将选择映射到 60-30-10 色调、字体与材质                         │
├─────────────────────────────────────────────────────────────┤
│ 3. 叙事与路由架构                                            │
│ 详细说明区块序列、标题和组件分解                                │
├─────────────────────────────────────────────────────────────┤
│ 4. 输出 supersite-plan.md 规格合约                            │
│ 持久化完整架构,供 /supersite-build 执行                     │
└─────────────────────────────────────────────────────────────┘

第一步:前沿发现访谈

向用户提出一组有针对性的问题。对于每个问题,提供结构化的选项并附上推荐的默认值,同时明确欢迎自定义指令。

问题模式:

问题 [N]:[主题]
[A](推荐)选项 1 描述
[B] 选项 2 描述
[C] 选项 3 描述

👉 回复选项字母(A、B、C)或直接输入您自己的具体指令。

零破折号规则(强制)

在提问、表述选项、撰写文案或回复用户时,绝不能使用长破折号(— 或 --)。长破折号会使访谈问题和选择显得像是 AI 合成模板。将想法分解为干净、自信的句子,或者改用冒号、逗号或括号。

4 个发现领域:

1. 网站范围与路由层级

  • [A](推荐)高转化着陆页: 单页叙事滚动,针对最大转化速率优化(Hero → 问题 → 产品预览 → 证据 → 定价 → CTA)。
  • [B] 多页 SaaS 架构: 多路由结构(/ 首页,/features 深度解析,/pricing 价格矩阵与 FAQ,/security 合规)。
  • [C] 工作室作品集与案例研究: 视觉展示(/ 展示卷,/work/[slug] 交互式案例研究,/inquire 联系表单)。

2. 美学类型与材质基础

  • [A](推荐)暗色精密: 黑曜石表面(#09090b),发丝边框(border-white/10),等宽遥测字体,激光翠绿或青色强调色。
  • [B] 静谧奢华: 触感象牙画布(#faf8f5),深森林绿墨水(#0c2217),香槟金细节,编辑衬线标题。
  • [C] 瑞士编辑: 宽幅新闻纸,实心 1px 黑色分隔网格,朱红色信号强调色,粗体无衬线/衬线对比。
  • [D] 现代企业: 清爽白色表面,深海军蓝信任强调色,SOC2/HIPAA 合规标识,密集对比表格。
  • [E] 大胆消费者: 暖奶油画布,2.5px 实心墨水边框,硬偏移投影,亮眼霓虹强调色,俏皮微文案。
  • [F] 电影工作室: 全视口暗色剧院舞台,环境背景暗角,现场产品展示,滚动驱动场景标记。

3. 核心能力与对比

  • 该产品消除了哪些具体的摩擦点或破旧的现状?
  • 哪个具体、可量化的指标证明了您的优越性(例如 "次 14ms 冷启动","零 AWS 出口费用" 而非泛泛的 "极快")?

4. 代码库关系

  • [A](推荐)全新纯净构建: 使用标准 Next.js、React、Tailwind CSS 和 Lucide 图标的新项目。
  • [B] 继承自现有代码库: 检查本地仓库(globals.css、Tailwind 令牌、package.json)以匹配现有产品品牌。

第二步:综合项目合约

在用户提供答案或指令后:

  1. 从 ../supersite/references/genres/ 加载对应的类型蓝图。
  2. 应用 ../supersite/references/anti-slop.md 中的防劣化规则。
  3. 使用 ../supersite/references/copy-craft.md 起草真实、高地位的标题和文案。
  4. 基于 ../supersite/references/component-system.md 定义可组合的组件分解。
  5. 执行零破折号规则:确保 supersite-plan.md 在描述、区块蓝图、标题和微文案中不包含任何长破折号(— 或 --)。

第三步:编写 supersite-plan.md

将已达成一致的架构持久化到项目根目录的 supersite-plan.md 中:

# ⚡ supersite 规格合约:[项目名称]

> 由 `/supersite-plan` 生成。使用 `/supersite-build` 执行。

## 1. 项目概览与目标受众
* **产品:** [简洁的产品描述]
* **目标受众:** [具体角色,例如高级基础架构工程师]
* **主要转化目标:** [例如部署免费集群 / 预约企业演示]

## 2. 设计系统令牌
* **美学类型:** [例如暗色精密]
* **60-30-10 色调:**
  * 60% 画布:`#09090b`(黑曜石)
  * 30% 结构:`#121317`(面板)/ `#27272a`(发丝边框)/ `#fafafa`(墨水)
  * 10% 激光强调色:`#10b981`(电光翠绿)
* **字体:** 显示(`Geist Sans`),遥测(`Geist Mono`)
* **圆角半径:** `rounded-lg`(按钮 8px,卡片 12px)

## 3. 站点导航与路由层级
* 路由 1:`/`(首页转化叙事)
* 路由 2:`/features`(架构与 API 深度解析)
* 路由 3:`/pricing`(交互式价格矩阵与 FAQ)

## 4. 逐区块蓝图
* **导航栏:** 粘性毛玻璃头部(`backdrop-blur-md`),Logo,链接,主要 CTA。
* **区块 1(主视觉区域):**
  * 标记:`v2.4 发布 // 分布式向量缓存`
  * 标题:*"部署无服务器向量索引,全球读取副本延时 12ms。"*
  * 副标题:*"在边缘存储嵌入。自动同步至 32 个区域,零出口费用。"*
  * CTA:*"立即部署集群"* + *"阅读 RFC"*
  * 产品可视化:实时标签化交互式终端(`TypeScript` / `cURL`)。
* **区块 2(问题对比):** 集中式数据库瓶颈与分布式边缘缓存的逐一对比。
* **区块 3(功能矩阵):** 3 个非对称单元(架构数据流、延时图表、SDK 易用性示例)。
* **区块 4(社会证明):** 量化指标(日均 1420 万向量,99.99% 正常运行时间)+ 2 条经过验证的工程师引述。
* **区块 5(价格矩阵):** 开发者(免费)、团队($49/月)、企业(自定义),含计费周期切换。
* **区块 6(FAQ):** 4 个技术披露手风琴。
* **页脚:** 站点地图,状态指示灯,版权与合规徽章。

## 5. 文件与组件清单
* `src/components/ui/container.tsx`
* `src/components/ui/section-header.tsx`
* `src/components/ui/button.tsx`
* `src/components/site/navbar.tsx`
* `src/components/site/hero.tsx`
* `src/components/site/problem-contrast.tsx`
* `src/components/site/feature-grid.tsx`
* `src/components/site/social-proof.tsx`
* `src/components/site/pricing-matrix.tsx`
* `src/components/site/faq-accordion.tsx`
* `src/components/site/footer.tsx`
* `src/config/site.ts`
* `src/types/site.ts`

## 6. 预检验证标准
* 无紫色渐变球体或通用 AI 污块。
* 符合 WCAG 2.2 AA 对比度要求(文本 ≥4.5:1,UI 边界 ≥3.0:1)。
* 移动端触摸目标 ≥44×44px。
* `npm run build` 成功,无 TypeScript 或样式警告。

第四步:下一步操作提示

在编写 supersite-plan.md 后,告知用户:

计划完成! 架构合约已写入 supersite-plan.md。 审查计划或提出任何调整。当您准备构建站点时,请触发: /supersite-build

Individual skills in this repo

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

相关技能