0. 文件結構(本 SKILL 的三個層次)
- 領域主體(§1 ~ §N):此 SKILL 的協議。
鎖定詞彙使用 0 項由
verify-policy --check body-neutrality自動驗證。 - 方法論主體 — 領域中立:在 Cycle 3 中以
<!-- BEGIN: cycle3-body-neutral -->~<!-- END: cycle3-body-neutral -->標記包圍的區域。 - 領域範例附錄(§A):MCU/MPU/WPF 領域的案例。
SoT (
policies/locked-vocab.json) 由scripts/gen-locked-vocab.mjs自動產生。
請勿直接編輯附錄 — 使用 node scripts/gen-locked-vocab.mjs 重新產生。
初學者(新手)技能
動作
| 動作 | 說明 | 範例 |
|---|---|---|
init | 專案初始化(/init-starter 功能) | /starter init my-portfolio |
guide | 顯示開發指南 | /starter guide |
help | 初學者幫助 | /starter help |
init(專案初始化)
- 建立專案目錄結構(HTML/CSS/JS 或 Next.js)
- 產生 package.json(選擇 Next.js 時)
- 建立 CLAUDE.md(指定為 Starter 等級)
- 建立 docs/ 文件夾結構(用於 PDCA 文件)
- 初始化 .rkit/state/memory.json
guide(開發指南)
- 分析目前專案狀態
- 建議適合 Starter 等級的下一步
- 階段 1-3 聚焦的 Pipeline 指南
help(初學者幫助)
- 解釋 HTML/CSS/JS 基本概念
- 回答常見問題
- 提供範例程式碼
目標對象
- 初次學習程式設計的人
- 想建立簡單網站的人
- 需要作品集網站的人
技術棧
選項 A:純 HTML/CSS/JS(適合完全初學者)
HTML5 → 網頁結構
CSS3 → 樣式設定
JavaScript → 動態功能(可選)
選項 B:Next.js(使用框架)
Next.js 14+ → 基於 React 的框架
Tailwind CSS → 工具類 CSS
TypeScript → 型別安全(可選)
語言層級指南(v1.3.0)
建議:僅使用第 1 層語言(Python、TypeScript、JavaScript)
Starter 等級專注於 AI 原生開發,擁有最佳的 AI 工具支援。
| 層級 | 允許 | 原因 |
|---|---|---|
| 第 1 層 | ✅ 是 | 完整 AI 支援,Vibe Coding 最佳化 |
| 第 2 層 | ⚠️ 有限 | 請考慮升級至 Dynamic 等級 |
| 第 3-4 層 | ❌ 否 | 請升級至 Dynamic/Enterprise |
專案結構
選項 A:HTML/CSS/JS
project/
├── index.html # 主頁面
├── about.html # 關於頁面
├── css/
│ └── style.css # 樣式
├── js/
│ └── main.js # JavaScript
├── images/ # 圖片檔案
├── docs/ # PDCA 文件
│ ├── 01-plan/
│ └── 02-design/
└── README.md
選項 B:Next.js
project/
├── src/
│ ├── app/
│ │ ├── layout.tsx # 共同佈局
│ │ ├── page.tsx # 主頁面
│ │ └── about/
│ │ └── page.tsx # 關於頁面
│ └── components/ # 可重複使用的元件
├── public/ # 靜態檔案
├── docs/ # PDCA 文件
├── package.json
├── tailwind.config.js
└── README.md
核心概念說明
HTML(網頁結構)
<!-- 基本結構 -->
<!DOCTYPE html>
<html lang="zh-TW">
<head>
<meta charset="UTF-8">
<title>我的網站</title>
<link rel="stylesheet" href="css/style.css">
</head>
<body>
<header>頁首</header>
<main>主要內容</main>
<footer>頁尾</footer>
</body>
</html>
CSS(樣式設定網頁)
/* 基本樣式 */
body {
font-family: 'Inter', sans-serif;
margin: 0;
padding: 0;
}
/* 居中對齊 */
.container {
max-width: 1200px;
margin: 0 auto;
padding: 20px;
}
/* 響應式(行動裝置支援) */
@media (max-width: 768px) {
.container {
padding: 10px;
}
}
Next.js App Router(建立頁面)
// app/page.tsx - 主頁面
export default function Home() {
return (
<main className="container mx-auto p-4">
<h1 className="text-3xl font-bold">
歡迎!
</h1>
</main>
);
}
// app/about/page.tsx - 關於頁面
// URL: /about
export default function About() {
return (
<div className="container mx-auto p-4">
<h1>關於</h1>
<p>我是 ...</p>
</div>
);
}
Tailwind CSS(快速樣式設定)
// 常用類別
<div className="
container // 居中對齊
mx-auto // 自動左右邊距
p-4 // 內距 16px
text-center // 文字置中
text-xl // 大字型
font-bold // 粗體
bg-blue-500 // 藍色背景
text-white // 白色文字
rounded-lg // 圓角
hover:bg-blue-600 // 滑鼠懸停時變色
">
部署方法
GitHub Pages(免費)
1. 建立 GitHub 儲存庫
2. 推送程式碼
3. Settings → Pages → Source: main 分支
4. 透過 https://username.github.io/repo-name 存取
Vercel(建議用於 Next.js)
1. 註冊 vercel.com(整合 GitHub)
2. 「New Project」→ 選擇儲存庫
3. 點選「Deploy」
4. 自動產生 URL
限制
❌ 登入/註冊(需要伺服器)
❌ 資料儲存(需要資料庫)
❌ 管理頁面(需要後端)
❌ 付款功能(需要後端)
何時升級
如果您有以下需求,請升級至 Dynamic 等級:
→ "我需要登入功能"
→ "我想儲存資料"
→ "我需要管理頁面"
→ "我希望使用者之間能互相溝通"
rkit 在 Starter 等級的功能(v1.5.1)
輸出風格:rkit-learning(建議)
為獲得最佳學習體驗,請啟動學習輸出風格:
/output-style rkit-learning
此風格提供:
- 每個任務後附有學習重點,說明您做了什麼以及原因
- TODO(learner) 標記鼓勵動手練習
- 針對初學者難度調整的概念說明
Agent Memory(自動啟用)
rkit 代理會自動記住您跨階段的學習進度。
無需設定 — 您的 starter-guide 代理使用 user 範圍記憶,
因此學習情境甚至會跨不同專案持續存在。
Agent Teams
Agent Teams 不適用於 Starter 等級的專案。 當您升級至 Dynamic 等級時,即可解鎖雙隊友並行 PDCA 模式。
常見錯誤
| 錯誤 | 解決方案 |
|---|---|
| 圖片無法顯示 | 檢查路徑(./images/photo.jpg) |
| CSS 未套用 | 檢查 link 標籤路徑 |
| 頁面導覽失效 | 檢查 href 路徑(./about.html) |
| 行動裝置顯示異常 | 檢查 <meta name="viewport"> 標籤 |