Communitygithub.com

solitasroh/rkit

適用於初學者和非開發人員的靜態網頁開發技能。涵蓋 HTML/CSS/JavaScript 及 Next.js App Router 基礎知識。可使用「init starter」或「starter init」進行專案初始化。

rkit 是什麼?

這是一個專為網頁開發初學者與非開發人員設計的 AI 輔助技能。它能引導使用者從零開始建立靜態網站,例如個人作品集、登陸頁面等,無需後端或資料庫。此技能支援兩種技術選項:純 HTML/CSS/JavaScript 及 Next.js 框架,並提供專案初始化、開發指南與初學者幫助等功能。根據原始 SKILL.md 文件,此技能在對話中為初學者提供結構化的學習路徑,包含專案結構生成、PDCA 文件夾建立、常見錯誤提示,以及部署至 GitHub Pages 或 Vercel 的步驟說明。同時,此技能會自動啟用「rkit-learning」輸出風格與 Agent Memory,以強化學習體驗。對於需要登入、資料儲存或後端功能的專案,此技能會建議使用者升級至 Dynamic 等級。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/solitasroh/rkit/tree/HEAD/skills/starter

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

0. 文件結構(本 SKILL 的三個層次)

  1. 領域主體(§1 ~ §N):此 SKILL 的協議。 鎖定詞彙使用 0 項由 verify-policy --check body-neutrality 自動驗證。
  2. 方法論主體 — 領域中立:在 Cycle 3 中以 <!-- BEGIN: cycle3-body-neutral --> ~ <!-- END: cycle3-body-neutral --> 標記包圍的區域。
  3. 領域範例附錄(§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(專案初始化)

  1. 建立專案目錄結構(HTML/CSS/JS 或 Next.js)
  2. 產生 package.json(選擇 Next.js 時)
  3. 建立 CLAUDE.md(指定為 Starter 等級)
  4. 建立 docs/ 文件夾結構(用於 PDCA 文件)
  5. 初始化 .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"> 標籤

相關技能