move: source_type: Default streichen, unclassified als sichtbares Fach, layout: fuer source (schliesst #66)

Files changed: - CHANGES.md - VERSION - instructions/dev/corpus-policy.md - instructions/wiki-ingest/SKILL.md - kb/index.md - kb/log.md - kb/sources/COLLECTION.md - kb/sources/INDEX.md - kb/sources/Source - AMD Powermanagement CPU.md - kb/sources/Source - Arch Linux Cheat Sheet.md - kb/sources/Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04.md - kb/sources/Source - Conversation - Auto Mode and Tool Choice Session 2026-08-31.md - kb/sources/Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31.md - kb/sources/Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31.md - kb/sources/Source - Conversation - Gate Counting and Measured Calibration Session 2026-08-31.md - kb/sources/Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31.md - kb/sources/Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31.md - kb/sources/Source - Conversation - Nightly Drift-Check Workflow and doctor's Bootstrap Gap Session 2026-08-31.md - kb/sources/Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31.md - kb/sources/Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30.md - kb/sources/Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31.md - kb/sources/Source - Copilot Skill Restructure Instructions.md - kb/sources/Source - Docker Cheatsheet.md - kb/sources/Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md - kb/sources/Source - Gitea Issues 62-63 - status-incoming Label Introduction 2026-09-04.md - kb/sources/Source - LLM Improvements Codex Analysis.md - kb/sources/Source - LLM Improvements Production Agent Gaps 2026.md - kb/sources/Source - LLM Improvements Sonnet Analysis.md - kb/sources/Source - LLM Wiki Pattern.md - kb/sources/Source - LLM Wiki v2.md - kb/sources/Source - MCP Read Server Implementation Session 2026-09-02.md - kb/sources/Source - Private-Instance Merge Correction and Issue 30 Session 2026-09-01.md - kb/sources/Source - Public Release, Corpus Purge and History Squash Session 2026-09-01.md - kb/sources/Source - Publish-Remote Gate and Issue Triage Session 2026-09-01.md - kb/sources/Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md - kb/sources/Source - Wine.md - kb/sources/Source - qmd - GitHub Repository.md - kb/sources/analyses/Source - Copilot Skill Restructure Instructions.md - kb/sources/analyses/Source - LLM Improvements Codex Analysis.md - kb/sources/analyses/Source - LLM Improvements Production Agent Gaps 2026.md - kb/sources/analyses/Source - LLM Improvements Sonnet Analysis.md - kb/sources/articles/Source - AMD Powermanagement CPU.md - kb/sources/articles/Source - LLM Wiki Pattern.md - kb/sources/articles/Source - LLM Wiki v2.md - kb/sources/documents/Source - qmd - GitHub Repository.md - kb/sources/notes/Source - Arch Linux Cheat Sheet.md - kb/sources/notes/Source - Docker Cheatsheet.md - kb/sources/notes/Source - Wine.md - kb/sources/trackers/Source - Gitea Issue 41 - Issue Management and Label Scheme 2026-09-02.md - kb/sources/trackers/Source - Gitea Issues 62-63 - status-incoming Label Introduction 2026-09-04.md - kb/sources/transcripts/Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04.md - kb/sources/transcripts/Source - Conversation - Auto Mode and Tool Choice Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Gate Counting and Measured Calibration Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Nightly Drift-Check Workflow and doctor's Bootstrap Gap Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31.md - kb/sources/transcripts/Source - Conversation - Versioning CI-CD and Content Migration Session 2026-08-30.md - kb/sources/transcripts/Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31.md - kb/sources/transcripts/Source - MCP Read Server Implementation Session 2026-09-02.md - kb/sources/transcripts/Source - Private-Instance Merge Correction and Issue 30 Session 2026-09-01.md - kb/sources/transcripts/Source - Public Release, Corpus Purge and History Squash Session 2026-09-01.md - kb/sources/transcripts/Source - Publish-Remote Gate and Issue Triage Session 2026-09-01.md - kb/sources/transcripts/Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md - tools/CONTRACT.md - tools/chemenu/lint_core.py - tools/chemenu/tests/conftest.py - tools/chemenu/tests/test_lint.py - tools/chemenu/tests/test_new_page.py - tools/chemenu/tests/test_provenance.py - tools/chemenu/tests/test_touch.py - tools/chemenu/tests/test_type_resolver.py - tools/chemenu/tests/test_xref.py - types/source.md - types/source.schema.yaml - types/type-spec.md - work/reclassify-source-types/README.md - work/reclassify-source-types/plan.md
2026-09-08 20:38:15 +02:00
parent 7f74303a00
commit b138fd8e64
51 changed files with 467 additions and 96 deletions
@@ -0,0 +1,66 @@
+---
+type: types/source.md
+source_type: analysis
+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]]