Communitygithub.com

solitasroh/rkit

初心者や非開発者向けの静的Web開発スキル。HTML/CSS/JavaScriptとNext.js App Routerの基本をカバーします。「init starter」または「starter init」でプロジェクトを初期化できます。

rkit とは?

「solitasroh/rkit」は、プログラミング学習を始めたばかりの初心者や、シンプルな静的Webサイトを手早く作りたい非開発者を主な対象としたAIエージェントスキルです。このスキルは、HTML/CSS/JavaScriptを使った純粋な静的サイトと、Next.js 14+とTailwind CSSを組み合わせたアプリケーションルーター形式の2つのテクノロジースタックをサポートしており、ユーザーの習熟度に応じて選択できます。プロジェクトの初期化(`init`アクション)では、ディレクトリ構造の作成、package.jsonの生成(Next.js選択時)、CLAUDE.mdのセットアップ、PDCAドキュメント用のdocs/フォルダ、学習進捗を記録する.rkit/state/memory.jsonまでを自動で行います。ガイド(`guide`アクション)は現在のプロジェクト状態を分析して初級者向けの適切な次のステップを提案し、ヘルプ(`help`アクション)ではHTML/CSS/JSの基本概念説明やよくある質問への回答、サンプルコードの提供を行います。学習体験を最大化する「rkit-learning」出力スタイルや、セッションをまたいでも学習進捗を記憶するエージェントメモリ機能も備えており、ログインやデータベースを必要とする本格的なフルスタックアプリには使用しない設計です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/solitasroh/rkit/tree/HEAD/skills/starter

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

0. ドキュメント構造(本スキルの三層)

  1. ドメイン本文 (§1 ~ §N):本スキルのプロトコル。 ロックされた語彙の使用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 を作成(レベル: スターター指定)
  4. docs/ フォルダ構造を作成(PDCAドキュメント用)
  5. .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"> タグを確認

関連スキル