0. ドキュメント構造(本スキルの三層)
- ドメイン本文 (§1 ~ §N):本スキルのプロトコル。
ロックされた語彙の使用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 を作成(レベル: スターター指定)
- docs/ フォルダ構造を作成(PDCAドキュメント用)
- .rkit/state/memory.json を初期化
guide(開発ガイド)
- 現在のプロジェクト状態を分析
- スターターレベルに適した次のステップを提案
- フェーズ1~3に焦点を当てたパイプラインガイド
help(初心者向けヘルプ)
- HTML/CSS/JSの基本概念を説明
- よくある質問に回答
- サンプルコードを提供
対象ユーザー
- プログラミングを初めて学ぶ方
- シンプルなWebサイトを作りたい方
- ポートフォリオサイトが必要な方
テクノロジースタック
オプションA: 純粋なHTML/CSS/JS(完全初心者向け)
HTML5 → Webページ構造
CSS3 → スタイリング
JavaScript → 動的な機能(オプション)
オプションB: Next.js(フレームワーク利用)
Next.js 14+ → Reactベースのフレームワーク
Tailwind CSS → ユーティリティCSS
TypeScript → 型安全性(オプション)
言語階層ガイダンス (v1.3.0)
推奨: 階層1の言語のみ(Python、TypeScript、JavaScript)
スターターレベルは、最大限の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(Webページ構造)
<!-- 基本構造 -->
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>My Website</title>
<link rel="stylesheet" href="css/style.css">
</head>
<body>
<header>Header</header>
<main>Main content</main>
<footer>Footer</footer>
</body>
</html>
CSS(Webページのスタイリング)
/* 基本スタイル */
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>About</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 branch
4. https://username.github.io/repo-name でアクセス
Vercel(Next.jsに推奨)
1. vercel.com にサインアップ(GitHub連携)
2. 「New Project」→ リポジトリを選択
3. 「Deploy」をクリック
4. URLが自動生成される
制限事項
❌ ログイン/登録(サーバーが必要)
❌ データ保存(データベースが必要)
❌ 管理ページ(バックエンドが必要)
❌ 決済機能(バックエンドが必要)
アップグレードのタイミング
以下のような要件が出てきたら Dynamicレベル に移行してください:
→ 「ログイン機能が必要」
→ 「データを保存したい」
→ 「管理ページが必要」
→ 「ユーザー同士が通信できるようにしたい」
スターターレベル向けrkit機能 (v1.5.1)
出力スタイル: rkit-learning(推奨)
最高の学習体験を得るために、学習用出力スタイルを有効にしてください:
/output-style rkit-learning
これにより以下の機能が提供されます:
- 各タスク終了後の学習ポイント:何をしたか、なぜそれを行ったかを説明
- TODO(learner)マーカー:実際に手を動かす練習を促す
- 初心者の難易度に合わせた概念説明
エージェントメモリ(自動有効)
rkitエージェントは、セッションをまたいでも学習進捗を自動的に記憶します。
設定は不要です — starter-guide エージェントは user スコープのメモリを使用するため、
異なるプロジェクト間でも学習コンテキストが維持されます。
エージェントチーム
エージェントチームはスターターレベルのプロジェクトでは利用できません。 Dynamicレベルにアップグレードすると、2人体制の並列PDCAモードが利用可能になります。
よくある間違い
| 間違い | 解決策 |
|---|---|
| 画像が表示されない | パスを確認(./images/photo.jpg) |
| CSSが適用されない | linkタグのパスを確認 |
| ページナビゲーションが機能しない | hrefパスを確認(./about.html) |
| モバイルで崩れる | <meta name="viewport"> タグを確認 |