edgeone-pages-website-skeleton

Files (6)

• SKILL.md
• ai-chat-module.md · references/
• auth-module.md · references/
• kv-storage.md · references/
• payment-module.md · references/
• templates.md · references/

SKILL.md (first lines)

# Website Skeleton Skill — EdgeOne Pages 全栈网站骨架

Scaffold and deploy a production-ready full-stack website on EdgeOne Pages from a single natural language request.

## When to use this skill

- User wants to **start a new full-stack website** (e-commerce, AI chatbot, SaaS admin) with zero config
- User mentions: e-commerce, shopping cart, payment, AI chat, admin dashboard, login/register, or similar
- User wants Edge Functions + Cloud Functions + KV + MySQL on EdgeOne Pages

**Do NOT use for:**
- Adding a single API/function to an existing project → use `edgeone-pages-dev`
- Deploying an already-built project → use `edgeone-pages-deploy`
- Pure static sites or blogs without business logic

---

## ⛔ Critical Rules (never skip)

1. **ALWAYS ask the user to confirm the scenario first.** Three built-in templates are available:
   - **E-commerce** (🛒)：Auth + Cart + Payment (WeChat/Alipay) + Orders + Admin
   - **AI Assistant** (🤖)：Auth + AI Chat (SSE streaming) + Admin
   - **SaaS Admin** (📊)：Auth + RBAC Admin + Subscription Payments
2. **Never fabricate the user's requirements.** If information is missing, ask clarifying questions before generating code.
3. **Respect EdgeOne Pages platform constraints:**
   - KV is only accessible from **Edge Functions** (not Cloud Functions)
   - Cloud Functions directory must be named `cloud-functions/`
   - bcrypt must run inside **Cloud Functions**
   - AI SSE streaming must be implemented in **Cloud Functions** (Edge cannot use `waitUntil`)
4. **Payment idempotency is mandatory.** Use Edge `putIfNotExists` with 24h TTL (< WeChat retry window of 72h).
5. **Never commit `.env.local` or any real API keys.** Ensure `.gitignore` covers it.
6. **Always verify EdgeOne Pages CLI is installed** before deployment.

---

## Main Flow

### Step 1 — Confirm scenario

Use `ask_followup_question` to ask:

> 你想要建什么类型的网站？
>
> - **🛒 电商站** — 登录注册、购物车、微信/支付宝支付、订单管理
> - **🤖 AI 客服站** — 登录注册、AI 对话（SSE 流式）、访客留言
> - **📊 SaaS 管理后台** — 登录注册、RBAC 权限、数据看板
> - **⚙️ 自定义** — 自由组合模块

Branch:
- E-commerce → use `references/templates.md` § "电商模板"
- AI Assistant → use `references/templates.md` § "AI助手模板"
- SaaS Admin → use `references/templates.md` § "管理后台模板"
- Custom → confirm which modules are needed

### Step 2 — Collect requirements

Read `references/templates.md` and confirm with user:
1. Site name / domain
2. Which modules to enable (Auth always required)
3. Payment providers (WeChat / Alipay / Both / None)
4. AI provider (if AI Chat enabled)

Output: a **Spec object**
```json
{
  "scenario": "e-commerce | ai-assistant | saas-admin | custom",
  "siteName": "...",
  "modules": ["auth", "cart", "payment", "ai-chat", "admin"],
  "paymentProviders": ["wx", "ali"],
  "aiProvider": "openai | hunyuan | none",
  "envVars": ["JWT_SECRET", "DATABASE_URL", ...]
}
```

Show the Spec back and ask for confirmation.

### Step 3 — Generate project structure

Based on the selected template, generate the following directory tree:

```
<project>/
├── client/                     # Next.js frontend (SPA)
│   ├── app/ (pages: login, register, cart, checkout, orders, admin/*)
│   ├── lib/ (api client, auth service, cart service, SSE client)
│   └── middleware (optional, for pure SPA)
├── edge-functions/            # Edge Functions (V8 + KV)
│   ├── _middleware.js         # JWT check + KV session + rate limit
│   └── api/
│       ├── auth/login.js     # JWT issue + KV session
│       ├── auth/me.js        # KV session read
│       ├── auth/refresh.js   # RT rotation with KV version lock
│       ├── auth/logout.js
│       ├── internal/idempotency.js  # Edge atomic idempotency lock ← P0
│       ├── products/list.js  # KV cache + MySQL fallback
│       ├── cart/*.js         # KV cart
│       ├── orders/list.js    # MySQL read
│       └── ai/history.js     # KV AI session history
├── cloud-functions/          # Cloud Functions (Node.js + MySQL)
│   ├── api/
│   │   ├── auth/register.js  # bcrypt cost=12 ← P0
│   │   ├── pay/create-order.js
│   │   ├── pay/wx-notify.js  # Edge idempotency lock ← P0
│   │   ├── pay/ali-notify.js
│   │   ├── order/create.js   # SELECT FOR UPDATE ← P0
│   │   ├── order/cancel.js
│   │   ├── admin/products.js
│   │   └── ai/chat-stream.js  # SSE streaming ← AI module
│   └── utils/
│       ├── db.js             # MySQL pool (mysql2/promise)
│       └── payment-sdk.js    # WeChat V3 / Alipay SDK
├── db/
│   ├── migrations/001_init.sql  # users, products, orders, order_items
│   └── seed.sql
├── docs/
│   └── env-vars.md           # Environment variable matrix
└── references/
    └── auth-module.md / payment-module.md / ai-chat-module.md / kv-storage.md
```

From TencentEdgeOne/awesome-website-prompts-and-skills, MIT.

More from TencentEdgeOne/awesome-website-prompts-and-skills