Communitygithub.com

solitasroh/rkit

Fähigkeit zur statischen Webentwicklung für Anfänger und Nicht-Entwickler. Deckt HTML/CSS/JavaScript und Next.js App Router Grundlagen ab. Projektinitialisierung mit "init starter" oder "starter init". Proaktiv nutzen, wenn der Benutzer ein Anfänger ist oder eine einfache statische Website wünscht.

Was ist rkit?

Diese Fähigkeit (Skill) richtet sich an absolute Anfänger und Nicht-Entwickler, die ihre erste statische Website oder ein Portfolio erstellen möchten. Sie bietet zwei Technologiepfade: reines HTML/CSS/JavaScript für komplette Neulinge und Next.js (App Router) mit Tailwind CSS für einen moderaten Einstieg in moderne Frameworks. Nach der Projektinitialisierung (über `init starter` oder `starter init`) erstellt sie die gesamte Verzeichnisstruktur, Konfigurationsdateien (z. B. `package.json`, `CLAUDE.md`) und eine `docs/`-Ordnerstruktur für die PDCA-Dokumentation. Über die Aktionen `guide` und `help` erhalten Anwender schrittweise Anleitungen, Next-Steps-Vorschläge und Erklärungen zu grundlegenden Konzepten. Die Fähigkeit erkennt automatisch den Lernfortschritt des Nutzers und speichert diesen über die Agent Memory-Funktion. Zudem wird ein spezieller Lern-Ausgabestil (`/output-style rkit-learning`) empfohlen, der nach jeder Aufgabe Lernpunkte und interaktive Marker (`TODO(learner)`) bereitstellt. Wichtig: Die Fähigkeit ist auf reine Frontend-Projekte ohne Backend, Authentifizierung oder Datenbanken beschränkt – bei Bedarf an serverseitigen Funktionen wird zum Upgrade auf das nächste Level (Dynamic) geraten.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

0. Dokumentenstruktur (Die drei Schichten dieser FÄHIGKEIT)

  1. Domänentext (§1 bis §N): Das Protokoll dieser FÄHIGKEIT. Die Verwendung von 0 gesperrten Vokabeln wird automatisch mit verify-policy --check body-neutrality überprüft.
  2. Methodik-Text — domänenneutral: In Cycle 3 der Bereich, der von den Markierungen <!-- BEGIN: cycle3-body-neutral --> ~ <!-- END: cycle3-body-neutral --> umschlossen wird.
  3. Domänenbeispiel-Anhang (§A): Beispiele für die MCU/MPU/WPF-Domänen. Wird automatisch von scripts/gen-locked-vocab.mjs aus der SoT (policies/locked-vocab.json) generiert.

Bearbeiten Sie den Anhang nicht direkt — er wird mit node scripts/gen-locked-vocab.mjs neu generiert.


Fähigkeit für Anfänger (Starter)

Aktionen

AktionBeschreibungBeispiel
initProjektinitialisierung (/init-starter-Funktion)/starter init my-portfolio
guideEntwicklungsleitfaden anzeigen/starter guide
helpHilfe für Anfänger/starter help

init (Projektinitialisierung)

  1. Projektverzeichnisstruktur erstellen (HTML/CSS/JS oder Next.js)
  2. package.json generieren (bei Auswahl von Next.js)
  3. CLAUDE.md erstellen (Level: Starter angegeben)
  4. docs/-Ordnerstruktur erstellen (für PDCA-Dokumente)
  5. .rkit/state/memory.json initialisieren

guide (Entwicklungsleitfaden)

  • Aktuellen Projektstatus analysieren
  • Nächste Schritte vorschlagen, die dem Starter-Level entsprechen
  • Pipeline-Leitfaden mit Fokus auf Phase 1–3

help (Hilfe für Anfänger)

  • Grundlegende Konzepte von HTML/CSS/JS erklären
  • Häufig gestellte Fragen beantworten
  • Beispielcode bereitstellen

Zielgruppe

  • Personen, die zum ersten Mal programmieren lernen
  • Personen, die eine einfache Website erstellen möchten
  • Personen, die eine Portfolio-Seite benötigen

Tech-Stack

Option A: Reines HTML/CSS/JS (Für absolute Anfänger)

HTML5        → Webseitenstruktur
CSS3         → Gestaltung
JavaScript   → Dynamische Funktionen (optional)

Option B: Next.js (Mit Framework)

Next.js 14+  → React-basiertes Framework
Tailwind CSS → CSS-Dienstprogramme
TypeScript   → Typsicherheit (optional)

Sprach-Tier-Anleitung (v1.3.0)

Empfohlen: Nur Tier-1-Sprachen (Python, TypeScript, JavaScript)

Starter-Level konzentriert sich auf KI-native Entwicklung mit maximaler KI-Tool-Unterstützung.

TierErlaubtGrund
Tier 1✅ JaVolle KI-Unterstützung, Vibe Coding optimiert
Tier 2⚠️ EingeschränktErwägen Sie stattdessen das Dynamic-Level
Tier 3-4❌ NeinUpgrade auf Dynamic/Enterprise

Projektstruktur

Option A: HTML/CSS/JS

project/
├── index.html          # Hauptseite
├── about.html          # Über-Seite
├── css/
│   └── style.css       # Styles
├── js/
│   └── main.js         # JavaScript
├── images/             # Bilddateien
├── docs/               # PDCA-Dokumente
│   ├── 01-plan/
│   └── 02-design/
└── README.md

Option B: Next.js

project/
├── src/
│   ├── app/
│   │   ├── layout.tsx      # Gemeinsames Layout
│   │   ├── page.tsx        # Hauptseite
│   │   └── about/
│   │       └── page.tsx    # Über-Seite
│   └── components/         # Mehrfach verwendbare Komponenten
├── public/                 # Statische Dateien
├── docs/                   # PDCA-Dokumente
├── package.json
├── tailwind.config.js
└── README.md

Erklärungen zu Kernkonzepten

HTML (Webseitenstruktur)

<!-- Grundstruktur -->
<!DOCTYPE html>
<html lang="de">
<head>
    <meta charset="UTF-8">
    <title>Meine Website</title>
    <link rel="stylesheet" href="css/style.css">
</head>
<body>
    <header>Kopfzeile</header>
    <main>Hauptinhalt</main>
    <footer>Fußzeile</footer>
</body>
</html>

CSS (Webseiten gestalten)

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

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

/* Responsiv (mobile Unterstützung) */
@media (max-width: 768px) {
    .container {
        padding: 10px;
    }
}

Next.js App Router (Seiten erstellen)

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

// app/about/page.tsx - Über-Seite
// URL: /about
export default function About() {
  return (
    <div className="container mx-auto p-4">
      <h1>Über mich</h1>
      <p>Ich bin ...</p>
    </div>
  );
}

Tailwind CSS (Schnelle Gestaltung)

// Häufig verwendete Klassen
<div className="
  container    // Zentrierte Ausrichtung
  mx-auto      // Automatischer linker/rechter Rand
  p-4          // Padding 16px
  text-center  // Text zentrieren
  text-xl      // Großer Text
  font-bold    // Fetter Text
  bg-blue-500  // Blauer Hintergrund
  text-white   // Weißer Text
  rounded-lg   // Abgerundete Ecken
  hover:bg-blue-600  // Farbwechsel beim Überfahren
">

Bereitstellungsmethoden

GitHub Pages (Kostenlos)

1. GitHub-Repository erstellen
2. Code pushen
3. Einstellungen → Pages → Quelle: main-Branch
4. Zugriff unter https://benutzername.github.io/repo-name

Vercel (Empfohlen für Next.js)

1. Bei vercel.com anmelden (GitHub-Integration)
2. "New Project" → Repository auswählen
3. Auf "Deploy" klicken
4. URL wird automatisch generiert

Einschränkungen

❌ Anmeldung/Registrierung (erfordert Server)
❌ Datenspeicherung (erfordert Datenbank)
❌ Admin-Seiten (erfordert Backend)
❌ Zahlungsfunktionen (erfordert Backend)

Wann ein Upgrade sinnvoll ist

Wechseln Sie zum Dynamic-Level, wenn Sie Folgendes benötigen:

→ „Ich brauche eine Anmeldefunktion“
→ „Ich möchte Daten speichern“
→ „Ich brauche eine Admin-Seite“
→ „Ich möchte, dass Benutzer miteinander kommunizieren“

rkit-Funktionen für Starter-Level (v1.5.1)

Ausgabestil: rkit-learning (Empfohlen)

Für das beste Lernerlebnis aktivieren Sie den Lernausgabestil:

/output-style rkit-learning

Dies bietet:

  • Lernpunkte nach jeder Aufgabe, die erklären, was Sie getan haben und warum
  • TODO(learner)-Markierungen, die zur praktischen Übung anregen
  • Konzepterklärungen, die für das Anfängerniveau angepasst sind

Agent Memory (Automatisch aktiv)

rkit-Agenten merken sich Ihren Lernfortschritt über verschiedene Sitzungen hinweg. Keine Einrichtung erforderlich — Ihr starter-guide-Agent verwendet den user-Speicherbereich, sodass der Lernkontext auch über verschiedene Projekte hinweg erhalten bleibt.

Agent Teams

Agent Teams sind für Projekte auf Starter-Level nicht verfügbar. Wenn Sie zum Dynamic-Level upgraden, erhalten Sie den parallelen PDCA-Modus mit 2 Teammitgliedern.


Häufige Fehler

FehlerLösung
Bild wird nicht angezeigtPfad überprüfen (./images/foto.jpg)
CSS wird nicht angewendetLink-Tag-Pfad überprüfen
Seitennavigation funktioniert nichthref-Pfad überprüfen (./about.html)
Probleme auf mobilen Geräten<meta name="viewport">-Tag überprüfen

Verwandte Skills