Communitygithub.com

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

從概念到可部署檔案,設計並建構完整、專業的網站。

FarmFriend-Terminal-React 是什麼?

此技能旨在引導 AI 代理作為專業網頁設計師與開發者,從概念發想到部署準備,完整建構生產就緒的網站。它涵蓋了全面的網站架構,包括資訊架構、多種頁面類型(首頁、關於、服務、作品集、聯絡、部落格、價格頁)以及響應式佈局模式。技能提供特定行業的範本,如專業服務、電子商務、作品集和餐廳網站,並整合現代網路技術,包括語意化 HTML5、CSS 自訂屬性、網格佈局、容器查詢和漸進增強 JavaScript。此外,它還強調效能最佳化(圖片、CSS、JavaScript)、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>打造美麗、功能完善的網路體驗</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">網頁</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>

現代網路技術

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/ (特定服務)
https://example.com/blog/            (部落格)
https://example.com/blog/post-slug/  (特定文章)
https://example.com/contact/         (聯絡我們)

3. 無障礙設計模式

<!-- 鍵盤導覽 -->
<nav role="navigation" aria-label="主要">
    <ul role="menubar">
        <li role="none">
            <a role="menuitem" href="/" aria-current="page">首頁</a>
        </li>
        <li role="none">
            <a role="menuitem" href="/services/">服務</a>
        </li>
    </ul>
</nav>

<!-- 無障礙表單 -->
<form aria-label="聯絡表單">
    <div class="form-field">
        <label for="name">姓名</label>
        <input type="text" id="name" name="name" required aria-required="true" aria-describedby="name-error">
        <span id="name-error" class="error-message" role="alert"></span>
    </div>
</form>

<!-- 跳轉連結 -->
<a href="#main-content" class="skip-link">跳至主要內容</a>

<!-- ARIA 標籤與描述 -->
<button aria-label="關閉選單" aria-expanded="false">
    <span class="hamburger-icon"></span>
</button>

<!-- 焦點管理 -->
<div role="dialog" aria-modal="true" aria-labelledby="dialog-title">
    <h2 id="dialog-title">確認操作</h2>
    <!-- 對話框內容 -->
</div>

設計系統整合

1. 設計代幣

:root {
    /* 顏色代幣 */
    --color-primary-50: #eff6ff;
    --color-primary-100: #dbeafe;
    --color-primary-200: #bfdbfe;
    --color-primary-300: #93c5fd;
    --color-primary-400: #60a5fa;
    --color-primary-500: #3b82f6;
    --color-primary-600: #2563eb;
    --color-primary-700: #1d4ed8;
    --color-primary-800: #1e40af;
    --color-primary-900: #1e3a8a;
    
    /* 間距代幣 */
    --space-1: 0.25rem;
    --space-2: 0.5rem;
    --space-3: 0.75rem;
    --space-4: 1rem;
    --space-5: 1.25rem;
    --space-6: 1.5rem;
    --space-8: 2rem;
    --space-10: 2.5rem;
    --space-12: 3rem;
    --space-16: 4rem;
    --space-20: 5rem;
    --space-24: 6rem;
    
    /* 排版代幣 */
    --font-size-xs: 0.75rem;
    --font-size-sm: 0.875rem;
    --font-size-base: 1rem;
    --font-size-lg: 1.125rem;
    --font-size-xl: 1.25rem;
    --font-size-2xl: 1.5rem;
    --font-size-3xl: 1.875rem;
    --font-size-4xl: 2.25rem;
    --font-size-5xl: 3rem;
    --font-size-6xl: 3.75rem;
}

2. 元件架構

components/
├── ui/
│   ├── Button/
│   │   ├── Button.jsx
│   │   ├── Button.css
│   │   └── Button.test.jsx
│   ├── Card/
│   │   ├── Card.jsx
│   │   ├── Card.css
│   │   └── Card.test.jsx
│   └── Form/
│       ├── Input.jsx
│       ├── Select.jsx
│       └── Form.css
├── layout/
│   ├── Header/
│   ├── Footer/
│   └── Navigation/
└── sections/
    ├── Hero/
    ├── Features/
    └── Testimonials/

3. 響應式設計中斷點

/* 中斷點 */
/* Small (sm):640px */
/* Medium (md):768px */
/* Large (lg):1024px */
/* Extra Large (xl):1280px */
/* 2X Large (2xl):1536px */

@media (min-width: 640px) {
    /* 小型裝置 */
}

@media (min-width: 768px) {
    /* 中型裝置 */
}

@media (min-width: 1024px) {
    /* 大型裝置 */
}

@media (min-width: 1280px) {
    /* 特大裝置 */
}

部署準備

1. 效能指標

目標指標:
- 首次內容繪製 (FCP):< 1.5 秒
- 最大內容繪製 (LCP):< 2.5 秒
- 首次輸入延遲 (FID):< 100 毫秒
- 累計版面配置位移 (CLS):< 0.1
- 互動到下一次繪製 (INP):< 200 毫秒

2. 檢查清單

  • 所有圖片已最佳化並使用正確格式
  • CSS 已最小化並內聯關鍵樣式
  • JavaScript 已最小化並適當分割
  • HTML 通過 W3C 驗證
  • 無障礙檢查已完成
  • SEO 中繼標籤已到位
  • 結構化資料已驗證
  • 表單提交與驗證功能完整
  • 跨瀏覽器測試已完成
  • 行動裝置響應式測試已完成
  • 效能審計通過
  • HTTPS 已啟用
  • CDN 已設定(若適用)
  • Analytics 追蹤已設定
  • 錯誤處理已到位

3. 建置與部署

# 建置命令範例
npm run build

# 環境變數
# .env.production
NODE_ENV=production
API_URL=https://api.example.com
SITE_URL=https://example.com

# 部署命令
npm run deploy

技術棧建議

React + TypeScript 棧

{
    "dependencies": {
        "react": "^18.2.0",
        "react-dom": "^18.2.0",
        "react-router-dom": "^6.0.0",
        "typescript": "^5.0.0",
        "styled-components": "^6.0.0",
        "@tanstack/react-query": "^5.0.0"
    },
    "devDependencies": {
        "vite": "^5.0.0",
        "@types/react": "^18.0.0",
        "eslint": "^8.0.0",
        "prettier": "^3.0.0"
    }
}

Next.js 棧

{
    "dependencies": {
        "next": "^14.0.0",
        "react": "^18.2.0",
        "@next/font": "^14.0.0",
        "next-seo": "^6.0.0"
    },
    "devDependencies": {
        "@types/node": "^20.0.0",
        "typescript": "^5.0.0",
        "tailwindcss": "^3.0.0"
    }
}

整合模式

1. CMS 整合

// 內容管理系統整合範例
async function fetchContent(type) {
    const response = await fetch(`/api/content/${type}`);
    const data = await response.json();
    return data;
}

// 快取策略
const cacheStrategy = {
    revalidate: 3600, // 1 小時
    tags: ['content', 'pages']
};

2. Analytics 整合

<!-- Google Analytics 4 -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
    window.dataLayer = window.dataLayer || [];
    function gtag(){dataLayer.push(arguments);}
    gtag('js', new Date());
    gtag('config', 'G-XXXXXXXXXX');
</script>

3. 表單處理

// 表單提交與處理
async function handleFormSubmit(formData) {
    try {
        const response = await fetch('/api/contact', {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(formData)
        });
        
        if (!response.ok) {
            throw new Error('表單提交失敗');
        }
        
        return await response.json();
    } catch (error) {
        console.error('表單錯誤:', error);
        throw error;
    }
}

品質保證

1. 程式碼標準

- 遵循 ESLint 與 Prettier 配置
- 使用 TypeScript 以達類型安全
- 撰寫單元測試與整合測試
- 遵循無障礙標準 (WCAG 2.1)
- 維持一致的命名慣例
- 記錄複雜邏輯與 API

2. 測試策略

// 單元測試範例
describe('Button 元件', () => {
    test('應正確渲染標籤', () => {
        render(<Button label="點擊我" />);
        expect(screen.getByText('點擊我')).toBeInTheDocument();
    });
    
    test('點擊時應觸發 onClick 處理器', () => {
        const handleClick = jest.fn();
        render(<Button onClick={handleClick} />);
        fireEvent.click(screen.getByRole('button'));
        expect(handleClick).toHaveBeenCalledTimes(1);
    });
});

3. 監控與維護

設定:
- 正常運行時間監控 (Pingdom, StatusCake)
- 錯誤追蹤 (Sentry, Rollbar)
- 效能監控 (Lighthouse CI, Web Vitals)
- 安全掃描 (OWASP, Snyk)
- 備份策略 (每日、每週)

相關技能