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.
63 lines
5.0 KiB
Markdown
63 lines
5.0 KiB
Markdown
---
|
|
type: types/source.md
|
|
source_type: notes
|
|
author: GitHub Copilot (Claude Sonnet 5)
|
|
raw_files: [raw/notes/Conversation Transcript - AGENTS.md Skill Restructuring Session 2026-08-04.md]
|
|
source_language: en
|
|
date: 2026-08-04
|
|
tags: [skills, agents-md, wikitool, fact-check, restructuring]
|
|
entities: [AGENTS.md, wikitool, Chemenu, GitHub Copilot, Claude Code, Codex CLI, Mistral Vibe]
|
|
concepts: [Cross-platform Agent Skills, Token Economics, Context Isolation]
|
|
summary: Geprüfte und umgesetzte Aufteilung der 5 Workflows aus AGENTS.md in 5 einzelne Skills unter .agents/skills/; korrigiert falsche und unbelegte Aussagen aus einem früheren, ungeprüften Ingest derselben Anweisungen
|
|
---
|
|
# Source: Conversation - AGENTS.md Skill Restructuring Session 2026-08-04
|
|
|
|
**Autor:** Torben
|
|
**Datum:** 2026-08-04
|
|
**Quelle:** raw/notes/Conversation Transcript - AGENTS.md Skill Restructuring Session 2026-08-04.md
|
|
**Typ:** notes
|
|
|
|
## Zusammenfassung
|
|
|
|
Diese Sitzung analysierte, ob die fünf Workflows von `AGENTS.md` in diskrete, unabhängig entdeckbare Agent-Skills umstrukturiert werden sollten, dann wurden Faktenprüfung und Implementierung dieser Umstrukturierung durchgeführt. Die Forschung stellte fest, dass VS Code Copilot's nativer Skill-Mechanismus (`.github/skills/`, `.agents/skills/`, `.claude/skills/` mit 3-stufiger progressiver Offenlegung) der eigentliche Enabler der Idee ist, die der Benutzer beschrieb - nicht Farzas Gist, das eine einzelne Skill-Datei mit Befehlsargument-Hinweis ist, nicht mehrere unabhängig entdeckbare Skills.
|
|
|
|
Der Benutzer fügte dann einen "Web-Suchergebnis, synthetisiert" Anweisungssatz ein, der eine konkrete plattformübergreifende Umstrukturierung über GitHub Copilot, Claude Code, Codex CLI und Mistral Vibe vorschlug. Jede konkrete technische Aussage in diesem Dokument wurde unabhängig gegen primäre Quellen überprüft (offizielle Claude Code/Codex/Mistral Vibe Dokumentation, `agentskills.io` und die zitierten GitHub Repositories), bevor sie für die Planung verwendet wurde, gemäß dieser Wiki's eigener "keine sichere Antwort ohne Quelle" Regel. Zwei Aussagen wurden als falsch oder nicht überprüfbar befunden und korrigiert: Codex CLI's echter Skill-Standort ist `.agents/skills/` (nativ, kein Symlink), nicht `~/.codex/skills/`; und die "5-8x"/"61% Reduktion, 100% Lösungsquote auf 8.260-Datei-Corpus" Token-Ökonomie-Statistiken haben keine auffindbare Quelle und wurden explizit aus dem Plan ausgeschlossen.
|
|
|
|
Die Umstrukturierung wurde dann implementiert: 5 Skills (`wiki-ingest`, `wiki-query`, `wiki-lint`, `wiki-manage`, `wiki-status`) unter `.agents/skills/`, gespiegelt zu `.claude/skills/` über neue `tools/wikitool skills sync`/`verify` Befehle, und root `AGENTS.md` von 745 auf ~573 Zeilen reduziert. Diese Quelle wird auch eingereicht, um spezifische falsche/nicht überprüfbare Aussagen zu ersetzen, die bereits aus einer früheren, nicht überprüfbaren Aufnahme desselben eingefügten Anweisungssatzes in der Wiki eingereicht wurden.
|
|
|
|
## Kernaussagen
|
|
|
|
- VS Code's nativer `SKILL.md` Progressive-Disclosure-Mechanismus (nicht Farzas Single-Skill-Design) ist das, was eine echte Multi-Skill-Aufteilung lohnenswert macht - nur der Körper des relevanten Skill wird geladen.
|
|
- Codex CLI liest nativ `.agents/skills/` (gescannt von CWD bis zum Repo-Root, plus `$HOME/.agents/skills/`) - kein Symlink erforderlich, was die frühere Ingest-Aussage korrigiert.
|
|
- Mistral Vibe liest nativ `.vibe/skills/` und `.agents/skills/` (Projekt, trusted-folder-gated) sowie die `~/.vibe/skills/`/`~/.agents/skills/` Benutzerbereich-Äquivalente - direkt bestätigt aus `mistralai/mistral-vibe`'s Quellcode und Changelog.
|
|
- Claude Code liest nur `.claude/skills/` (Projekt) oder `~/.claude/skills/` (persönlich/Plugin) - es liest `.agents/skills/` nicht nativ, daher ist ein erzeugter Spiegel erforderlich.
|
|
- Die "5-8x Token-Kosten" und "61%/100% Lösungsquote auf 8.260 Dateien" Statistiken aus dem eingefügten Anweisungssatz haben keine auffindbare Quelle und sollten nirgends in dieser Wiki als Fakt behandelt werden.
|
|
- `kfchou/wiki-skills`, `vanillaflava/wiki-skills-vanillaflava` und `yugasun/llm-wiki-skills` sind alle echte Repositories, die dieses allgemeine Muster implementieren, bestätigt durch direkte Repository-Inspektion.
|
|
|
|
## Aufgaben
|
|
|
|
- [x] AGENTS.md in 5 Skills unter `.agents/skills/` umstrukturieren
|
|
- [x] `tools/wikitool skills sync`/`verify` hinzufügen und zu `.claude/skills/` spiegeln
|
|
- [ ] Falsche `~/.codex/skills/` Aussage in `Codex CLI.md` korrigieren
|
|
- [ ] Nicht überprüfte Token-Ökonomie-Statistiken in `Token Economics.md` kennzeichnen
|
|
- [ ] Die empirische "entdeckt Copilot `.agents/skills/` mit Zero-Config" Prüfung in einer zukünftigen Sitzung erneut ausführen (in dieser Sitzung unklar)
|
|
|
|
## Verwandte Entities
|
|
|
|
- [[AGENTS.md]]
|
|
- [[wikitool]]
|
|
- [[Chemenu]]
|
|
- [[GitHub Copilot]]
|
|
- [[Claude Code]]
|
|
- [[Codex CLI]]
|
|
- [[Mistral Vibe]]
|
|
- [[wiki-skills]]
|
|
- [[wiki-skills-vanillaflava]]
|
|
- [[llm-wiki-skills]]
|
|
|
|
## Verwandte Concepts
|
|
|
|
- [[Cross-platform Agent Skills]]
|
|
- [[Token Economics]]
|
|
- [[Context Isolation]]
|