Communitygithub.com

0-CYBERDYNE-SYSTEMS-0/FarmFriend-Terminal-React

从概念到部署,设计和构建完整、专业的网站。

FarmFriend-Terminal-React 是什么?

该技能(Skill)旨在指导 AI 代理(如 Claude Code、Cursor、Codex)成为专业的网页设计师和开发者,能够从头到尾创建生产就绪的网站。它涵盖了全面的网站架构,包括信息架构、多种页面类型(首页、关于、服务、作品集、联系、博客、定价)以及响应式布局模式。技能还提供了针对多个行业的特定模式,如专业服务、电子商务、作品集和餐厅网站,并附有完整的 HTML/CSS/JavaScript 代码示例。除了基础构建,该技能还深入讲解了现代 Web 技术(语义 HTML5、CSS 自定义属性、CSS Grid、渐进增强 JS)、性能优化(图片优化、CSS/JS 分块、Service Worker)以及 SEO 最佳实践(元标签、结构化数据、语义 URL 结构),确保生成的网站不仅外观精美,而且运行高效且易于被搜索引擎发现。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0-CYBERDYNE-SYSTEMS-0/FarmFriend-Terminal-React/tree/HEAD/skills/website_design

在你喜欢的 AI 中提问

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

预览

来自技能 README

FarmFriend-Terminal-React preview
FarmFriend-Terminal-React preview
FarmFriend-Terminal-React preview

文档

网站设计技能说明

你是专业的网页设计师和开发者,能够从概念到部署创建完整的、生产就绪的网站。当此技能被触发时,应构建涵盖以下内容的综合性网站:

网站架构

1. 信息架构

  • 设计直观的导航结构
  • 创建清晰的用户旅程和内容层级
  • 在所有页面中实现一致的导航
  • 为复杂站点包含站点地图和面包屑导航
  • 规划可扩展性和内容增长

2. 页面类型与模板

  • 首页:英雄区域、价值主张、关键特性、行动号召
  • 关于页面:公司故事、团队、使命、价值观
  • 服务/产品页面:服务内容、定价、功能对比
  • 作品集/图库页面:作品展示、案例研究、项目详情
  • 联系页面:联系表单、位置信息、社交链接
  • 博客/新闻页面:文章列表、分类、搜索功能
  • 定价页面:套餐对比、功能对比、注册表单

3. 响应式布局模式

/* 移动优先导航 */
.nav-primary {
    display: none;
}

.nav-toggle {
    display: block;
}

@media (min-width: 768px) {
    .nav-toggle { display: none; }
    .nav-primary { display: flex; }
}

/* 响应式内容布局 */
.main-content {
    display: grid;
    grid-template-columns: 1fr;
    gap: var(--space-4);
}

@media (min-width: 1024px) {
    .main-content {
        grid-template-columns: 2fr 1fr;
    }
}

@media (min-width: 1280px) {
    .main-content {
        grid-template-columns: 3fr 1fr 1fr;
    }
}

特定行业模式

1. 专业服务网站

<header class="hero-section">
    <div class="container">
        <h1>带来成果的专业服务</h1>
        <p>100多家公司信赖我们的创新解决方案</p>
        <a class="btn btn-primary" href="#contact">立即开始</a>
    </div>
</header>

<section class="services-section">
    <div class="container">
        <h2>我们的服务</h2>
        <div class="services-grid">
            <div class="service-card">
                <h3>咨询服务</h3>
                <p>业务增长的战略指导</p>
            </div>
            <!-- 更多服务卡片 -->
        </div>
    </div>
</section>

<section class="testimonials-section">
    <div class="container">
        <h2>客户成功案例</h2>
        <div class="testimonials-slider">
            <!-- 推荐语卡片 -->
        </div>
    </div>
</section>

2. 电子商务网站

<section class="product-showcase">
    <div class="container">
        <div class="product-grid">
            <article class="product-card">
                <img src="product.jpg" alt="产品名称" loading="lazy">
                <h3>产品名称</h3>
                <p class="price">$99.99</p>
                <button class="btn btn-primary">加入购物车</button>
            </article>
        </div>
    </div>
</section>

<section class="cart-section">
    <div class="container">
        <h2>购物车</h2>
        <div class="cart-items">
            <!-- 购物车商品行 -->
        </div>
        <div class="cart-summary">
            <p>小计: <span id="subtotal">$0.00</span></p>
            <button class="btn btn-primary">结帐</button>
        </div>
    </div>
</section>

3. 作品集网站

<section class="portfolio-hero">
    <div class="container">
        <h1>创意开发与设计师</h1>
        <p>打造美观、实用的Web体验</p>
        <div class="hero-cta">
            <a class="btn btn-primary" href="#portfolio">查看我的作品</a>
            <a class="btn btn-secondary" href="#contact">取得联系</a>
        </div>
    </div>
</section>

<section class="portfolio-grid">
    <div class="container">
        <div class="filter-nav">
            <button class="filter-btn active" data-filter="all">全部</button>
            <button class="filter-btn" data-filter="web">Web</button>
            <button class="filter-btn" data-filter="mobile">移动端</button>
        </div>
        <div class="projects-grid">
            <!-- 带悬停效果的项目卡片 -->
        </div>
    </div>
</section>

4. 餐厅网站

<section class="restaurant-hero">
    <div class="container">
        <h1>始于1985年的地道美食</h1>
        <p>体验令我们与众不同的风味</p>
        <div class="hero-cta">
            <a class="btn btn-primary" href="#menu">查看菜单</a>
            <a class="btn btn-secondary" href="#reservation">预约餐位</a>
        </div>
    </div>
</section>

<section class="menu-section">
    <div class="container">
        <h2>我们的菜单</h2>
        <div class="menu-categories">
            <div class="category-tab active" data-category="appetizers">开胃菜</div>
            <div class="category-tab" data-category="mains">主菜</div>
            <div class="category-tab" data-category="desserts">甜品</div>
        </div>
        <div class="menu-items">
            <!-- 带价格和描述的菜品卡片 -->
        </div>
    </div>
</section>

<section class="reservation-section">
    <div class="container">
        <h2>预约餐位</h2>
        <form class="reservation-form">
            <div class="form-group">
                <label for="date">日期</label>
                <input type="date" id="date" required>
            </div>
            <div class="form-group">
                <label for="time">时间</label>
                <input type="time" id="time" required>
            </div>
            <div class="form-group">
                <label for="guests">用餐人数</label>
                <select id="guests" required>
                    <option value="1">1位</option>
                    <option value="2">2位</option>
                    <option value="3">3位</option>
                    <option value="4">4位以上</option>
                </select>
            </div>
            <button type="submit" class="btn btn-primary">预订餐桌</button>
        </form>
    </div>
</section>

现代Web技术

1. 语义化HTML5结构

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="description" content="专业网站描述">
    <meta name="keywords" content="相关, 关键词">
    <meta property="og:title" content="网站标题">
    <meta property="og:description" content="网站描述">
    <meta property="og:image" content="/images/og-image.jpg">
    <title>网站标题</title>
    <link rel="canonical" href="https://example.com/">
    <!-- Favicon -->
    <link rel="icon" type="image/x-icon" href="/favicon.ico">
</head>
<body>
    <header role="banner">
        <!-- 导航和品牌标识 -->
    </header>
    
    <nav role="navigation" aria-label="主导航">
        <!-- 主导航 -->
    </nav>
    
    <main role="main">
        <!-- 页面内容 -->
        <section aria-labelledby="section-title">
            <h1 id="section-title">章节标题</h1>
        </section>
    </main>
    
    <aside role="complementary">
        <!-- 侧边栏内容 -->
    </aside>
    
    <footer role="contentinfo">
        <!-- 页脚内容 -->
    </footer>
    
    <script src="/scripts/main.js" defer></script>
</body>
</html>

2. 现代CSS特性

/* 用于主题的CSS自定义属性 */
:root {
    --primary-color: #0066cc;
    --secondary-color: #6c757d;
    --success-color: #28a745;
    --warning-color: #ffc107;
    --error-color: #dc3545;
    --font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
    --border-radius: 8px;
    --transition: all 0.3s ease;
}

/* 现代布局技术 */
.hero-section {
    display: grid;
    place-items: center;
    min-height: 80vh;
    background: linear-gradient(135deg, var(--primary-color), var(--secondary-color));
}

.card-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
    gap: var(--space-4);
}

/* 平滑动画 */
.fade-in {
    opacity: 0;
    transform: translateY(20px);
    animation: fadeIn 0.6s ease forwards;
}

@keyframes fadeIn {
    to {
        opacity: 1;
        transform: translateY(0);
    }
}

/* 交互式悬停效果 */
.service-card:hover {
    transform: translateY(-5px);
    box-shadow: 0 10px 30px rgba(0,0,0,0.1);
}

/* 用于组件自适应的容器查询 */
.component-container {
    container-type: inline-size;
}

@container (min-width: 400px) {
    .component-container {
        display: grid;
        grid-template-columns: 1fr 1fr;
    }
}

3. 渐进增强JavaScript

// 特性检测
const supports = {
    intersectionObserver: 'IntersectionObserver' in window,
    cssGrid: CSS.supports('display', 'grid'),
    fetch: 'fetch' in window
};

// 图片懒加载
if (supports.intersectionObserver) {
    const imageObserver = new IntersectionObserver((entries) => {
        entries.forEach(entry => {
            if (entry.isIntersecting) {
                const img = entry.target;
                img.src = img.dataset.src;
                img.classList.remove('lazy');
                imageObserver.unobserve(img);
            }
        });
    });
    
    document.querySelectorAll('img[data-src]').forEach(img => {
        imageObserver.observe(img);
    });
}

// 平滑滚动导航
document.querySelectorAll('a[href^="#"]').forEach(anchor => {
    anchor.addEventListener('click', function (e) {
        e.preventDefault();
        const target = document.querySelector(this.getAttribute('href'));
        if (target) {
            target.scrollIntoView({
                behavior: 'smooth',
                block: 'start'
            });
        }
    });
});

// 表单验证与增强
const enhanceForms = () => {
    document.querySelectorAll('form').forEach(form => {
        // 实时验证
        form.addEventListener('input', (e) => {
            const field = e.target;
            const isValid = field.checkValidity();
            field.classList.toggle('valid', isValid);
            field.classList.toggle('invalid', !isValid && field.value);
        });
        
        // 可访问的错误消息
        form.addEventListener('submit', (e) => {
            if (!form.checkValidity()) {
                e.preventDefault();
                showFormErrors(form);
            }
        });
    });
};

// DOM就绪时初始化
if (document.readyState === 'loading') {
    document.addEventListener('DOMContentLoaded', enhanceForms);
} else {
    enhanceForms();
}

性能优化

1. 图片优化

<!-- 带艺术指导的响应式图片 -->
<picture>
    <source media="(min-width: 1024px)" srcset="hero-large.webp 1x, [email protected] 2x">
    <source media="(min-width: 768px)" srcset="hero-medium.webp 1x, [email protected] 2x">
    <img src="hero-small.webp" alt="英雄区图片" loading="lazy" width="1200" height="600">
</picture>

<!-- 视口下方图片的懒加载 -->
<img data-src="/images/content-image.jpg" alt="内容描述" class="lazy" loading="lazy">

2. CSS优化

/* 内联关键CSS */
/* 仅首屏样式 */

/* 非关键CSS异步加载 */
<link rel="preload" href="/styles/non-critical.css" as="style" onload="this.onload=null;this.rel='stylesheet'">

/* 字体加载优化 */
@font-face {
    font-family: 'Custom Font';
    src: url('/fonts/custom.woff2') format('woff2');
    font-display: swap;
}

3. JavaScript优化

// 使用动态导入进行代码分割
const loadModule = async (moduleName) => {
    const module = await import(`/modules/${moduleName}.js`);
    return module.default;
};

// 用于缓存的Service Worker
if ('serviceWorker' in navigator) {
    window.addEventListener('load', () => {
        navigator.serviceWorker.register('/sw.js');
    });
}

SEO最佳实践

1. 元标签与结构化数据

<head>
    <!-- 必要元标签 -->
    <title>页面标题 - 最多60个字符</title>
    <meta name="description" content="引人入胜的描述 - 最多160个字符">
    <meta name="keywords" content="5-7个相关关键词">
    
    <!-- Open Graph -->
    <meta property="og:title" content="页面标题">
    <meta property="og:description" content="页面描述">
    <meta property="og:image" content="https://example.com/image.jpg">
    <meta property="og:url" content="https://example.com/current-page">
    <meta property="og:type" content="website">
    
    <!-- Twitter Card -->
    <meta name="twitter:card" content="summary_large_image">
    <meta name="twitter:title" content="页面标题">
    <meta name="twitter:description" content="页面描述">
    <meta name="twitter:image" content="https://example.com/image.jpg">
    
    <!-- 结构化数据 -->
    <script type="application/ld+json">
    {
        "@context": "https://schema.org",
        "@type": "LocalBusiness",
        "name": "企业名称",
        "description": "企业描述",
        "url": "https://example.com",
        "telephone": "+1-555-0123",
        "address": {
            "@type": "PostalAddress",
            "streetAddress": "123 Main St",
            "addressLocality": "城市",
            "addressRegion": "州",
            "postalCode": "12345"
        }
    }
    </script>
</head>

2. 语义化URL结构

https://example.com/                (首页)
https://example.com/about/           (关于页面)
https://example.com/services/        (服务)
https://example.com/services/consulting/ (具体服务)
...

3. 可访问性与语义

<!-- 使用引导航样式 */
.skip-link {
    position: absolute;
    top: -40px;
    left: 0;
    background: var(--primary-color);
    color: white;
    padding: 8px;
    z-index: 100;
    transition: top 0.3s;
}

.skip-link:focus {
    top: 0;
}

<!-- 语义化内容布局 -->
<header>
    <a href="#main-content" class="skip-link">跳到主内容</a>
    <!-- 导航栏 -->
</header>

<main id="main-content">
    <!-- 页面主内容 -->
</main>

<!-- 表单字段中的aria属性 -->
<div class="form-group">
    <label for="email" id="email-label">邮箱地址</label>
    <input type="email" id="email" 
           aria-required="true"
           aria-describedby="email-hint email-error"
           required>
    <span id="email-hint" class="hint">我们将向此邮箱地址发送确认信息。</span>
    <span id="email-error" class="error" role="alert"></span>
</div>

部署准备

1. 构建与资产优化

{
    "scripts": {
        "build": "npm run build:html && npm run build:css && npm run build:js && npm run optimize:assets",
        "build:html": "html-minifier --input-dir ./src --output-dir ./dist --collapse-whitespace",
        "build:css": "postcss ./src/styles/main.css -o ./dist/styles/main.css",
        "build:js": "webpack --mode production",
        "optimize:assets": "npm run optimize:images && npm run optimize:fonts",
        "optimize:images": "imagemin ./src/images/* --out-dir ./dist/images",
        "test": "npm run test:html && npm run test:accessibility",
        "deploy": "npm run build && surge ./dist https://your-site.surge.sh"
    }
}

2. 安全检查

<!-- 安全标头(在服务器配置或CDN中设置) -->
<!-- Content-Security-Policy: default-src 'self'; script-src 'self' https://analytics.example.com; style-src 'self' 'unsafe-inline' -->
<!-- X-Frame-Options: DENY -->
<!-- X-Content-Type-Options: nosniff -->
<!-- Referrer-Policy: strict-origin-when-cross-origin -->

3. 跨浏览器兼容性

/* 供应商前缀(在构建期间添加,例如使用Autoprefixer) */
.autoprefixer-grid {
    display: -ms-grid;
    display: grid;
    -ms-grid-columns: 1fr 1fr 1fr;
    grid-template-columns: 1fr 1fr 1fr;
    gap: 20px;
}

/* 功能查询以确保渐进式支持 */
@supports (display: grid) {
    .main-content {
        display: grid;
        grid-template-columns: 2fr 1fr;
        gap: 30px;
    }
}

/* 回退布局 */
.no-grid .main-content {
    display: flex;
    flex-wrap: wrap;
}

.no-grid .main-content > * {
    flex: 1 1 300px;
}

工作流程

1. 项目初始化

# 创建项目结构
mkdir -p project-name/{src/{pages,styles,scripts,assets/{images,fonts,icons}},dist}

# 初始化包管理
npm init -y

# 安装开发依赖
npm install --save-dev html-minifier postcss-cli autoprefixer webpack webpack-cli

2. 开发流程

  1. 分析需求和用户故事
  2. 设计信息架构
  3. 创建线框和原型
  4. 使用HTML5语义结构开发
  5. 使用现代CSS框架设计样式
  6. 添加渐进增强JavaScript
  7. 进行性能优化
  8. 确保可访问性合规
  9. 测试跨浏览器兼容性
  10. 部署到生产环境

3. 持续监控

  • 使用Lighthouse审计跟踪性能指标
  • 监控用户行为分析
  • 定期更新依赖以保证安全性
  • 维护内容管理系统(如果已集成)
  • 根据需要迭代设计

相关技能