Communitygithub.com

solitasroh/rkit

Compétence de développement web statique pour débutants et non-développeurs. Couvre les bases de HTML/CSS/JavaScript et de Next.js App Router.

Qu'est-ce que rkit ?

Cette compétence, conçue pour les débutants et les non-développeurs, facilite la création de sites web statiques simples comme des portfolios ou des pages d'accueil. Elle prend en charge deux options techniques : du HTML/CSS/JavaScript pur pour les vrais débutants et Next.js (App Router) pour ceux qui souhaitent utiliser un framework moderne. L'initialisation de projet se fait via la commande `init starter` ou `starter init`, qui génère automatiquement la structure de répertoires, les fichiers de configuration et les documents PDCA. La compétence inclut des explications de concepts fondamentaux (HTML, CSS, JavaScript, Next.js, Tailwind CSS), des guides de déploiement (GitHub Pages, Vercel), et un suivi de progression avec mémoire d'agent. Elle est activée automatiquement pour les utilisateurs débutants ou lorsque les mots-clés comme 'site web statique', 'portefolio' ou 'page d'accueil' sont détectés. En revanche, elle ne doit pas être utilisée pour des applications fullstack avec backend, authentification ou base de données.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

0. Structure du document (les trois couches de cette COMPÉTENCE)

  1. Corps du domaine (§1 ~ §N) : protocole de cette COMPÉTENCE. L'utilisation de vocabulaire verrouillé (0 occurrence) est vérifiée automatiquement par verify-policy --check body-neutrality.
  2. Corps méthodologique — neutre par domaine : zone délimitée par <!-- BEGIN: cycle3-body-neutral --> ~ <!-- END: cycle3-body-neutral --> dans le Cycle 3.
  3. Annexe d'exemples par domaine (§A) : cas par domaine MCU/MPU/WPF. Générée automatiquement par scripts/gen-locked-vocab.mjs à partir de la SoT (policies/locked-vocab.json).

Ne modifiez pas l'annexe directement — régénérez-la avec node scripts/gen-locked-vocab.mjs.


Compétence Débutant (Starter)

Actions

ActionDescriptionExemple
initInitialisation du projet (fonctionnalité /init-starter)/starter init mon-portfolio
guideAfficher le guide de développement/starter guide
helpAide pour débutants/starter help

init (Initialisation du projet)

  1. Créer la structure de répertoires du projet (HTML/CSS/JS ou Next.js)
  2. Générer le fichier package.json (lorsque Next.js est sélectionné)
  3. Créer CLAUDE.md (Niveau : Starter spécifié)
  4. Créer la structure du dossier docs/ (pour les documents PDCA)
  5. Initialiser .rkit/state/memory.json

guide (Guide de développement)

  • Analyser l'état actuel du projet
  • Suggérer les prochaines étapes adaptées au niveau Starter
  • Guide Pipeline axé sur les phases 1 à 3

help (Aide pour débutants)

  • Expliquer les concepts de base de HTML/CSS/JS
  • Répondre aux questions fréquentes
  • Fournir des exemples de code

Public cible

  • Personnes apprenant la programmation pour la première fois
  • Personnes souhaitant créer un site web simple
  • Personnes ayant besoin d'un site portfolio

Pile technique

Option A : HTML/CSS/JS pur (pour les vrais débutants)

HTML5        → Structure de la page web
CSS3         → Mise en forme
JavaScript   → Fonctionnalités dynamiques (optionnel)

Option B : Next.js (avec framework)

Next.js 14+  → Framework basé sur React
Tailwind CSS → CSS utilitaire
TypeScript   → Sécurité des types (optionnel)

Guide des niveaux de langage (v1.3.0)

Recommandé : uniquement les langages de niveau 1 (Python, TypeScript, JavaScript)

Le niveau Starter se concentre sur le développement natif IA avec un support maximal des outils d'IA.

NiveauAutoriséRaison
Niveau 1✅ OuiSupport IA complet, optimisé Vibe Coding
Niveau 2⚠️ LimitéEnvisagez plutôt le niveau Dynamic
Niveau 3-4❌ NonPassez au niveau Dynamic/Enterprise

Structure du projet

Option A : HTML/CSS/JS

project/
├── index.html          # Page principale
├── about.html          # Page À propos
├── css/
│   └── style.css       # Styles
├── js/
│   └── main.js         # JavaScript
├── images/             # Fichiers images
├── docs/               # Documents PDCA
│   ├── 01-plan/
│   └── 02-design/
└── README.md

Option B : Next.js

project/
├── src/
│   ├── app/
│   │   ├── layout.tsx      # Mise en page commune
│   │   ├── page.tsx        # Page principale
│   │   └── about/
│   │       └── page.tsx    # Page À propos
│   └── components/         # Composants réutilisables
├── public/                 # Fichiers statiques
├── docs/                   # Documents PDCA
├── package.json
├── tailwind.config.js
└── README.md

Explications des concepts fondamentaux

HTML (Structure de la page web)

<!-- Structure de base -->
<!DOCTYPE html>
<html lang="fr">
<head>
    <meta charset="UTF-8">
    <title>Mon Site Web</title>
    <link rel="stylesheet" href="css/style.css">
</head>
<body>
    <header>En-tête</header>
    <main>Contenu principal</main>
    <footer>Pied de page</footer>
</body>
</html>

CSS (Mise en forme des pages web)

/* Styles de base */
body {
    font-family: 'Inter', sans-serif;
    margin: 0;
    padding: 0;
}

/* Centrage */
.container {
    max-width: 1200px;
    margin: 0 auto;
    padding: 20px;
}

/* Responsive (support mobile) */
@media (max-width: 768px) {
    .container {
        padding: 10px;
    }
}

Next.js App Router (Création de pages)

// app/page.tsx - Page principale
export default function Home() {
  return (
    <main className="container mx-auto p-4">
      <h1 className="text-3xl font-bold">
        Bienvenue !
      </h1>
    </main>
  );
}

// app/about/page.tsx - Page À propos
// URL : /about
export default function About() {
  return (
    <div className="container mx-auto p-4">
      <h1>À propos</h1>
      <p>Je suis ...</p>
    </div>
  );
}

Tailwind CSS (Mise en forme rapide)

// Classes fréquemment utilisées
<div className="
  container    // Centrage
  mx-auto      // Marges gauche/droite automatiques
  p-4          // Padding 16px
  text-center  // Texte centré
  text-xl      // Texte grand
  font-bold    // Texte en gras
  bg-blue-500  // Fond bleu
  text-white   // Texte blanc
  rounded-lg   // Coins arrondis
  hover:bg-blue-600  // Changement de couleur au survol
">

Méthodes de déploiement

GitHub Pages (Gratuit)

1. Créer un dépôt GitHub
2. Pousser le code
3. Paramètres → Pages → Source : branche main
4. Accès à https://username.github.io/nom-du-depot

Vercel (Recommandé pour Next.js)

1. S'inscrire sur vercel.com (intégration GitHub)
2. "New Project" → Sélectionner le dépôt
3. Cliquer sur "Deploy"
4. URL générée automatiquement

Limitations

❌ Connexion/Inscription (nécessite un serveur)
❌ Stockage de données (nécessite une base de données)
❌ Pages d'administration (nécessite un backend)
❌ Fonctionnalités de paiement (nécessite un backend)

Quand passer au niveau supérieur

Passez au niveau Dynamic si vous avez besoin :

→ "J'ai besoin d'une fonctionnalité de connexion"
→ "Je veux stocker des données"
→ "J'ai besoin d'une page d'administration"
→ "Je veux que les utilisateurs communiquent entre eux"

Fonctionnalités rkit pour le niveau Starter (v1.5.1)

Style de sortie : rkit-learning (Recommandé)

Pour une meilleure expérience d'apprentissage, activez le style de sortie d'apprentissage :

/output-style rkit-learning

Celui-ci fournit :

  • Points d'apprentissage après chaque tâche expliquant ce que vous avez fait et pourquoi
  • Marqueurs TODO(apprenant) encourageant la pratique active
  • Explications de concepts adaptées au niveau débutant

Mémoire d'agent (Auto-active)

Les agents rkit mémorisent automatiquement votre progression d'apprentissage entre les sessions. Aucune configuration nécessaire — votre agent starter-guide utilise la mémoire de portée user, donc le contexte d'apprentissage persiste même entre différents projets.

Équipes d'agents

Les équipes d'agents ne sont pas disponibles pour les projets de niveau Starter. Lorsque vous passez au niveau Dynamic, vous débloquez le mode PDCA parallèle avec 2 coéquipiers.


Erreurs courantes

ErreurSolution
L'image ne s'affiche pasVérifiez le chemin (./images/photo.jpg)
Le CSS ne s'applique pasVérifiez le chemin de la balise link
La navigation entre pages ne fonctionne pasVérifiez le chemin href (./about.html)
Cassé sur mobileVérifiez la balise <meta name="viewport">

Skills associés