cline/site-specification

site-specification 是做什麼的？

來自 cline/skills 的代理技能「site-specification」。

此技能定義如何為網站或網路應用程式建立和管理結構化的規格。它為 AI 代理提供了一個框架，用以記錄頁面、功能、使用者角色、資料模型和設計約束條件。

功能

• 結構化規格：以一致的格式定義頁面、元件和 API 端點。
• 使用者角色：指定權限和使用者類型。
• 資料模型：定義實體、屬性與關係。
• 設計約束：設定品牌、版面與體驗的邊界條件。

使用方式

1. 建立一個 specification.md 檔案（或任何您偏好的名稱）。
2. 使用底下定義的區段來記錄您的網站。
3. 讓 AI 代理在實作期間參考此規格。

範例結構

# 網站規格

## 頁面

### 首頁
- **路徑**: `/`
- **目標**：歡迎使用者並提供主要號召。
- **區段**：英雄橫幅、特色、見證。

### 產品詳情頁
- **路徑**: `/products/:id`
- **目標**：展示單一產品並允許加入購物車。
- **資料關聯**：從 `/api/products/:id` 獲取資料。

## 使用者角色

- **訪客**：可以瀏覽產品，但無法下單。
- **客戶**：可以瀏覽並下單。
- **管理員**：可以管理產品與訂單。

## 資料模型

### 使用者
- `id`: UUID
- `email`: 字串（唯一）
- `role`: 列舉（訪客、客戶、管理員）

### 產品
- `id`: UUID
- `name`: 字串
- `price`: 浮點數
- `stock`: 整數

## 設計約束

- **調色盤**：主要色 `#333`，次要色 `#999`。
- **字型**：系統預設無襯線字型。
- **響應式**：支援桌面、平板與行動裝置。

最佳實務

• 保持規格簡潔，但足夠細節以消除歧義。
• 隨著設計決策的演進，更新規格。
• 當功能具有依賴性時，使用雙向連結。

相容平台

此技能設計為與任何支援自訂技能的 AI 代理環境相容，包括：

• Claude Code
• Cursor
• Codex CLI
• 以及更多

---

此技能提供規範性指引，並非嚴格模板。請根據您專案的特定需求進行調整。