AI Skills & Agent 教學平台

SECTION 01

專案定位與目標

AI 技術在 2026 年已進入代理（Agent）時代。三大頂尖 AI 公司持續以驚人速度更新模型與工具鏈，企業與開發者急需一個可靠的中文知識整理與實作資源平台。

中文

全繁體中文說明，降低學習門檻，搭配術語對照表

下載

Skill 檔案一鍵下載（.md），直接套用到自己的 IDE 工具

整合

三大 AI 生態系統一覆蓋，從模型到 IDE 工具完整對照

特色	本平台	現有英文文件（LangChain / Hugging Face）
語言	繁體中文為主	英文為主
內容形式	教學 + 即用範本	技術文件
Skill 下載	一鍵下載 .md 檔	無
模型覆蓋	三大公司全覆蓋，即時更新	各自分散

SECTION 02

三大 AI 生態系現況

資料截止：2026 年 5 月 22 日

Anthropic

Constitutional AI · 安全優先

現役模型

Claude Opus 4.7

旗艦推理，SWE-bench 87.6%，1M token

Claude Sonnet 4.6

開發者首選，預設推薦，200K token

Claude Haiku 4.5

輕量快速，首個 Haiku 加入 Extended Thinking

IDE / 工具

Claude Code CLI VS Code 擴充 JetBrains Cursor Windsurf Claude in Chrome

MD 控制檔

CLAUDE.md AGENTS.md

Google DeepMind

Gemini 系列 · Agent 優先

I/O 2026 更新

現役模型

Gemini 3.5 Flash

2026/5/19 GA ★ 超越 3.1 Pro，速度為競品 4 倍

最新

GPT-5.4 Pro / Thinking

付費層深度推理，付費預設

GPT-5.3 Instant

全用戶免費預設

IDE / 工具

Codex CLI GitHub Copilot Cursor Windsurf ChatGPT Canvas

MD 控制檔

AGENTS.md copilot-instructions.md

SECTION 03

MD 控制檔原則

在 IDE 工具中透過 Markdown 檔案控制 AI 代理行為，是 2025–2026 年最重要的工程實踐之一。以 AGENTS.md 作為業界通用主檔，各工具再以補充方式擴充。

各工具控制檔位置對照

控制檔	位置	適用工具	說明
AGENTS.md	專案根目錄	所有主流工具	業界通用標準，Linux Foundation 維護
CLAUDE.md	根目錄或 ~/.claude/	Claude Code	啟動時自動載入，可子目錄覆蓋
GEMINI.md	~/.gemini/ 或根目錄	Gemini CLI / Antigravity	/memory show 可檢查載入狀況
copilot-instructions.md	.github/ 目錄下	GitHub Copilot	注意放在 .github/（非根目錄）
.cursor/rules/*.mdc	.cursor/rules/	Cursor	最細粒度，可按前後端分別設定

七條黃金撰寫原則

RULE 01

具體勝於抽象

「使用 named exports，禁止 default exports」優於「遵循現代 JS 風格」

RULE 02

分層管理

全域偏好放 ~/，專案規則放根目錄，子模組放子目錄可覆蓋

RULE 03

明列禁止行為

短清單每條一行，未經許可不得修改 Schema / 核心模組

RULE 04

AGENTS.md 為主

其他工具以 symlink 或 hook 方式補充，避免多份版本漂移

RULE 05

納入 Git 版本控制

MD 控制檔 commit 進 Git，全隊 AI 助手使用相同規則集

RULE 06

保持精簡

建議 150 行以內，過長在 token 壓力下會被截斷或忽略

RULE 07

記錄關鍵指令

列出 AI 無法從 package.json / Makefile 推導的自訂指令：部署 hook、資料庫遷移、特殊腳本

# AGENTS.md 標準範本結構
# Project Overview
[專案一句話說明：技術棧 + 核心功能]

## Tech Stack
- Frontend: Next.js 15, Tailwind CSS, TypeScript strict
- Backend: Node.js, Prisma ORM, PostgreSQL
- Testing: Vitest, Playwright

## Code Conventions
- 使用 named exports，禁止 default exports
- 錯誤向上傳遞，僅在模組邊界使用 try/catch
- 所有 API 輸入使用 zod 驗證

## Prohibited Actions（需明確許可）
- 修改 /src/db/schema.ts
- 刪除 /src/core/ 下任何檔案
- 變更認證中介層 /src/middleware/auth.ts

## Directory Structure
/src/app    — Next.js App Router
/src/core   — 核心業務邏輯（無框架相依）
/tests      — 測試檔案

## Commands
npm run dev         — 啟動開發伺服器
npm run db:migrate  — 套用資料庫遷移
  

SECTION 04

教學內容架構

入門模組

什麼是 AI Skill？
什麼是 AI Agent？
三大公司模型比較

Skills 教學

Skill 檔案結構解析
文件處理 / 程式碼生成
資料分析 Skill
自訂 Skill 撰寫指南

Agent 教學

Agent 工作原理
Tool Use 實作
多步驟推理設計
Multi-Agent 協作

IDE 整合

Claude Code 完整設置
Cursor 多模型使用
Gemini CLI 快速上手
GitHub Copilot 企業

MD 控制原則

AGENTS.md 撰寫規範
CLAUDE.md 最佳實踐
GEMINI.md 設定指南
企業團隊規範建立

每課單元結構

① 概念說明（中文）
② 實作示範（步驟）
③ Skill 下載（.md）
④ 練習題 + 解答
⑤ 常見問題 FAQ

SECTION 05

技術架構設計

技術選型

層級	技術
前端	Next.js 15 + Tailwind CSS
後端	Node.js + Hono API
資料庫	PostgreSQL + Prisma ORM
檔案儲存	Cloudflare R2（S3 相容）
認證	Clerk / Auth.js
前端部署	Vercel（自動 CI/CD）
後端部署	Railway
搜尋	PostgreSQL Full-Text Search

系統架構

使用者瀏覽器
    │
    ▼
Vercel CDN（Next.js 15）
    │
    ├─ 靜態頁面（SSR 優化 SEO）
    └─ API Routes
           │
           ▼
     Railway 後端
           │
           ├─ PostgreSQL
           │    ├─ skills / courses / users
           │    └─ downloads / progress
           │
           └─ Cloudflare R2
                └─ *.md Skill 檔案
      

SECTION 06

開發時程（14 週）

PHASE 0

需求確認與技術選型

第 1 週

確認功能範圍與優先級
產出技術規格書
確定人力與分工

PHASE 1

原型設計與資料庫設計

第 2–3 週

Figma UI 原型（首頁、Skill 庫、課程頁）
PostgreSQL Schema 設計
Cloudflare R2 結構規劃

PHASE 2

前後端基礎架構搭建

第 4–6 週

Next.js 15 初始化，認證系統整合
Railway 後端 API 骨架
CI/CD Pipeline（GitHub Actions）

PHASE 3

核心功能開發（Skill 庫 + 下載）

第 7–9 週

Skill 清單頁（搜尋、篩選、排序）
一鍵下載 API + 計數系統
後台管理介面（上傳、發布、版本）

PHASE 4

課程系統與會員功能

第 10–11 週

課程章節、進度追蹤
會員等級（訪客 / 免費 / 企業）
書籤、評分功能

PHASE 5

內容填充（中文說明撰寫）

第 12–13 週

完成 30+ Skill 檔案（含中文說明）
撰寫 5 個核心課程模組
三大公司模型對照頁

PHASE 6

測試、優化、正式上線

第 14 週

E2E 測試、效能優化
SEO 審查
正式發布 + 推廣

SECTION 07

預算與人力規劃

前端工程師

28–35萬

全職 14 週

後端工程師

28–35萬

全職 14 週

內容撰寫者

6–10萬

半職 8 週，1–2 人

UI/UX 設計師

4–6萬

兼職 4 週

初期建置費用總估（人力）約 NT$ 66–86 萬

月度雲端費用

服務	說明	月費估算（NTD）
Vercel Pro	前端部署、CDN	~$900
Railway	後端 API 主機	~$600–1,500
Cloudflare R2	Skill 檔案儲存	~$300–800
PostgreSQL Managed	Neon / Supabase	~$600–1,200
Clerk（認證）	依用戶數計費	~$0–1,500
合計		約 $2,400–6,000 / 月

SECTION 08

風險管理

風險	機率	衝擊	緩解策略
AI 模型更新過快，內容過時	高	中	建立版本標記制度，每季更新模型對照表，標示「最後驗證日期」
內容品質不一致	中	高	制定撰寫風格指南，每篇內容設審核流程，建立 Skill 評分機制
Skill 檔案版權疑慮	低	高	所有 Skill 由內部原創，加入 CC BY 授權聲明，禁止直接搬運第三方內容
用戶黏著度不足	中	高	設計社群貢獻機制（評分、回饋），定期更新新 Skill，發送 Newsletter
技術人力不足	中	高	提前招募，備選外包廠商，功能採 MVP 優先，分階段上線

SECTION 09

未來擴展藍圖

短期 · 上線後 3–6 個月

鞏固基礎

英文介面支援（多語系）
使用者貢獻 Skill（社群投稿 + 審核）
課程完成認證徽章
Skill 使用數據儀表板

中期 · 6–12 個月

智能化擴展

AI 個人化學習推薦
企業版 API（開放 Skill 庫）
線上 Skill 編輯器
Skill 版本 diff 比較工具

長期 · 12 個月以上

生態系建立

Skills & Agent 能力認證考試
IDE 深度插件（Cursor / VS Code）
訂閱式企業客製課程
AI 自動更新模型對照資料

三大公司模型快速對照（截至 2026/5/22）

公司	最新旗艦	推薦 IDE 工具	MD 控制檔
Anthropic	Claude Opus 4.7	Claude Code CLI, Cursor	`CLAUDE.md` / `AGENTS.md`
Google	Gemini 3.5 Flash ★ (I/O 2026)	Gemini CLI, Antigravity 2.0	`GEMINI.md` / `AGENTS.md`
OpenAI	GPT-5.5（Spud）	Codex CLI, GitHub Copilot	`AGENTS.md` / `copilot-instructions.md`

AI Skills & Agent教學網站專案計畫

AI Skills & Agent
教學網站專案計畫