torben/chemenu
1
1
Fork 0
Code Issues 26 Pull Requests Actions Packages Releases 32 Activity
Files
f93d14b9d75dbd66f56adff84a52322fab7513cc
chemenu/kb/sources/analyses/Source - Copilot Skill Restructure Instructions.md
T
torben 00220f8b07 backfill: fidelity/authority auf allen 29 Source-Seiten (#67, Publish 2/3) 
Files changed:
- kb/index.md
- kb/log.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
- work/backfill-capture-fields/README.md
- work/backfill-capture-fields/plan.md
2026-09-09 06:50:01 +02:00

4.7 KiB
Raw Blame History

type, source_type, author, raw_files, source_language, date, tags, entities, concepts, summary, fidelity, authority
type source_type author raw_files source_language date tags entities concepts summary fidelity authority
types/source.md analysis Torben
raw/notes/copilot-skill-restructure-instructions.md
en 2026-08-03
skills
restructure
cross-platform
agents
Chemenu
AGENTS.md
wikitool
GitHub Copilot
Claude Code
Codex CLI
Mistral Vibe
awesome-llm-wiki
Cross-platform Agent Skills
Token Economics
Scale Ceiling
Workflow Extraction
Context Isolation
Anweisungssatz zur Aufteilung der monolithischen AGENTS.md in einzelne plattformübergreifende Agent-Skills unknown normative

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

Verwandte Concepts

Reference in New Issue View Git Blame Copy Permalink