torben
18ae28f918
Chemenu kompiliert Rohnotizen zu einem verlinkten, quellengebundenen Wiki: raw/ -> types/ + tools/ -> kb/ -> reports/. Was mechanisch ist, macht tools/wikitool; was Urteil braucht, macht ein Agent unter Contracts, deren Grenzen in Code durchgesetzt sind statt im Prompt. Dieser Commit ist der Startpunkt der oeffentlichen Historie. Die vorherige Entwicklung fand in einer privaten Instanz statt und ist nicht Teil dieses Repositorys; ihre Erzaehlung steht vollstaendig in CHANGES.md, das mit 44 Eintraegen von 0.1.0 bis 2.1.0 erhalten geblieben ist. Der mitgelieferte Korpus ist ein Testbett und eine Demo: 170 Seiten ueber den Stack selbst - Gates, Lint, Versionierung, Suche, das Wiki-Muster. Er dokumentiert das Werkzeug mit den eigenen Mitteln des Werkzeugs. Lizenz: AGPL-3.0 fuer den Stack (tools/, types/), CC-BY-4.0 fuer die Inhalte. Die Grenze zwischen beiden ist der Dateiplan, den dist export berechnet - siehe NOTICE.
67 lines
4.7 KiB
Markdown
67 lines
4.7 KiB
Markdown
---
|
|
type: types/source.md
|
|
source_type: notes
|
|
author: Torben
|
|
raw_files: [raw/notes/copilot-skill-restructure-instructions.md]
|
|
source_language: en
|
|
date: 2026-08-03
|
|
tags: [skills, restructure, cross-platform, agents]
|
|
entities: [Chemenu, AGENTS.md, wikitool, GitHub Copilot, Claude Code, Codex CLI, Mistral Vibe, awesome-llm-wiki]
|
|
concepts: [Cross-platform Agent Skills, Token Economics, Scale Ceiling, Workflow Extraction, Context Isolation]
|
|
summary: Anweisungssatz zur Aufteilung der monolithischen AGENTS.md in einzelne plattformübergreifende Agent-Skills
|
|
---
|
|
# Source: Copilot Skill Restructure Instructions
|
|
|
|
**Autor:** Torben
|
|
**Datum:** 2026-08-03
|
|
**Quelle:** raw/notes/copilot-skill-restructure-instructions.md
|
|
**Typ:** notes
|
|
|
|
## Zusammenfassung
|
|
|
|
Dieses Dokument bietet umfassende Anweisungen zur Umstrukturierung der monolithischen Datei `AGENTS.md` (~30KB) in diskrete, abrufbare Agent-Skills, die identisch in GitHub Copilot (VS Code), Claude Code, Codex CLI und Mistral Vibe funktionieren. Die Umstrukturierung zielt darauf ab, Tokenökonomiefragen und Skalierungsgrenzen zu beheben, indem prozedurale Workflows von deklarativen Regeln getrennt werden, um kontexteffiziente Operationen zu ermöglichen, bei denen für jede Aufgabe nur relevante Anweisungen geladen werden.
|
|
|
|
Das Dokument beschreibt einen Ziel-Skill-Satz von fünf (optional sechs) eigenständigen Skills: `wiki-ingest`, `wiki-query`, `wiki-lint`, `wiki-create`, `wiki-update` und optional `wiki-status`. Jeder Skill soll in sich geschlossen in `.agents/skills/wiki-<name>/SKILL.md` gemäß einer bestimmten Struktur mit den Abschnitten Purpose, Trigger, Steps, wikitool-Befehlen und Output sein. Die Wurzeldatei `AGENTS.md` soll auf deklarativen, übergreifenden Inhalt wie Architektur, Entity-/Concept-Typen, Beziehungstypen, Benennungskonventionen, Provenance-Regeln und Konfidenz-Bewertung reduziert werden.
|
|
|
|
Das Dokument beschreibt ein plattformübergreifendes Dateien-Layout mit `.agents/skills/` als gemeinsames Verzeichnis, mit werkzeugspezifischen Wiring-Anweisungen für Claude Code, Codex CLI, Mistral Vibe und GitHub Copilot. Es enthält eine Ausführungscheckliste und betont, dass es sich um eine strukturelle Extraktion handelt (keine Umschreibung) - alle Workflow-Schritte, Befehle und Regeln müssen wörtlich beibehalten werden.
|
|
|
|
## Kernaussagen
|
|
|
|
- **Tokenökonomiefrage**: Eine auf jede Aufgabe geladene monolithische Anweisungsdatei kostet das 5-8fache der Token-Quellenanzahl, auch für einfache Abfragen. Single-Context-Ansätze verschlechtern sich in Qualität, sobald ein Wiki ~100-200 Seiten überschreitet.
|
|
- **Lösungspräzedenz**: Mehrere Ökosystem-Implementierungen (kfchou/wiki-skills, Leo Alexandru's Setup, vanillaflava/wiki-skills-vanillaflava, yugasun/llm-wiki-skills) demonstrieren plattformübergreifende Skill-Verteilung mit Kontextisolation.
|
|
- **Zielarchitektur**: Fünf Skills (wiki-ingest, wiki-query, wiki-lint, wiki-create, wiki-update) im Verzeichnis `.agents/skills/`, mit reduzierter Wurzeldatei AGENTS.md, die nur Schema und Richtlinien enthält.
|
|
- **Dateien-Layout**: Gemeinsames Verzeichnis `.agents/skills/` mit werkzeugspezifischen Symlinks oder Konfiguration, die darauf verweist.
|
|
- **Bewahrungsprinzip**: Dies ist eine verlustfreie Verschiebung - Workflow-Abschnitte wörtlich aus AGENTS.md in Skill-Dateien extrahieren, jeden nummerierten Schritt, wikitool-Befehl und jede Regel bewahren.
|
|
|
|
## Aufgaben
|
|
|
|
- [ ] `.agents/skills/wiki-ingest/SKILL.md` bis `.agents/skills/wiki-update/SKILL.md` erstellen
|
|
- [ ] Workflow-Abschnitte wörtlich aus AGENTS.md in entsprechende Skill-Dateien extrahieren
|
|
- [ ] Wurzeldatei AGENTS.md umschreiben, um nur deklarativen Inhalt zu enthalten (Architektur, Entity-/Concept-Typen, Beziehungstypen, Seitenformate, Benennungskonventionen, Provenance-Regeln, Konfidenz-Bewertung, Qualitätsstandards, IT-spezifische Richtlinien, Wartungsplan, Nutzerpräferenzen, Versionshistorie)
|
|
- [ ] Abschnitt „Skills" oben in der Wurzeldatei AGENTS.md hinzufügen, der die fünf Skill-Namen mit einzeiligen Zwecken auflistet
|
|
- [ ] `.vscode/settings.json` mit `chat.agentSkillsLocations`-Eintrag erstellen/aktualisieren
|
|
- [ ] Verifizieren, dass kein Workflow-Schritt, wikitool-Aufruf oder Regel während der Extraktion verloren ging
|
|
- [ ] Versionstabelle in AGENTS.md mit neuer Zeile zur Beschreibung dieser Umstrukturierung aktualisieren
|
|
|
|
## Verwandte Entities
|
|
|
|
- [[Chemenu]]
|
|
- [[AGENTS.md]]
|
|
- [[wikitool]]
|
|
- [[GitHub Copilot]]
|
|
- [[Claude Code]]
|
|
- [[Codex CLI]]
|
|
- [[Mistral Vibe]]
|
|
- [[awesome-llm-wiki]]
|
|
- [[wiki-skills]]
|
|
- [[wiki-skills-vanillaflava]]
|
|
- [[llm-wiki-skills]]
|
|
|
|
## Verwandte Concepts
|
|
|
|
- [[Cross-platform Agent Skills]]
|
|
- [[Token Economics]]
|
|
- [[Scale Ceiling]]
|
|
- [[Workflow Extraction]]
|
|
- [[Context Isolation]]
|