Yinyo Skill Craft — Skill 工匠 (德国)

Yinyo Skill Craft — Skill 工匠

Skill-Engineering-Audit und interaktives Reparaturwerkzeug. Basiert auf dem offiziellen Perplexity Agents Team-Leitfaden + Karpathy CLAUDE.md-Codierungsstandards + praktischen Erfahrungen aus der Yinyo-Serie.

Neue Fähigkeit: Unterstützt automatische Reparatur + Benutzerbestätigungsmodus.

Kernregeln

1. Skill ist ein Verzeichnis, keine Datei

• Einzeldatei > 50KB → Muss in eine Hub-and-Spoke-Struktur aufgeteilt werden
• Standardstruktur: SKILL.md + README.md + docs/ + examples/ + subskills/
• Mehrstufige Verschachtelung: 300 Themen → 20 Bereiche → 15 Themen/Bereich

2. Description ist der Routing-Trigger

• Muss mit Load when... beginnen
• Beschreibt die Auslösebedingungen, keine Funktionsliste
• Maximal 50 Zeichen

3. Dreistufiges progressives Laden

Ebene	Token-Budget	Inhalt	Zahlungshäufigkeit
Index	~100	Name + Beschreibung	Pro Sitzung
Body	~5000	Kernregeln + Schnellreferenz	Nach dem Laden bis zur Komprimierung
Runtime	Keine Obergrenze	docs/ + examples/ + subskills/	Bei Bedarf

4. Modellbekannte Inhalte löschen

• Erklärung grundlegender Konzepte → Löschen
• Allgemeine Programmierprinzipien → Löschen
• "If it's easy to explain, the model already knows it. Delete it."

5. Karpathys vier Codierungsprinzipien

• Think Before Coding: Bei Unsicherheit fragen
• Simplicity First: 200 Zeilen, wenn möglich, nicht 500 Zeilen schreiben
• Surgical Changes: Nur das berühren, was berührt werden muss
• Goal-Driven Execution: Überprüfbare Ziele definieren

Interaktiver Reparaturprozess (Neu)

Reparaturprinzipien

1. Niedriges Risiko (Struktur, Format, Version) → Automatisch ausführen, danach Bericht erstatten
2. Mittleres Risiko (Beschreibung umschreiben) → Vorher-Nachher-Vergleich anzeigen, Benutzer bestätigt
3. Hohes Risiko (Inhalte löschen) → Löschliste anzeigen, Punkt für Punkt bestätigen

Reparaturumfang

Reparaturtyp	Beispiel	Risikostufe
Strukturanpassung	Einzeldatei in Verzeichnis aufteilen	Niedrig
Beschreibung umschreiben	In Load when... umwandeln	Mittel
Inhalte löschen	Modellbekannte Inhalte löschen	Hoch
Versionssynchronisation	Version/last_updated aktualisieren	Niedrig
Formatstandardisierung	Frontmatter ergänzen	Niedrig

Reparaturprozess

Audit → Probleme auflisten → Risiko klassifizieren → Benutzer bestätigen → Automatische Reparatur → Zweites Audit → Ergebnisse melden

Überprüfung nach der Reparatur

• Automatisches zweites Audit durchführen
• Ergebnisse vor und nach der Reparatur vergleichen
• Reparaturbericht erstellen (Was geändert, warum geändert, Bewertungsänderung)

Auditprozess

Eingabe

Benutzer bereitstellt:

• Pfad zum Skill-Verzeichnis, oder
• Inhalt der SKILL.md

Ausgabe

Auditbericht generieren:

## Auditbericht: {skill-name}

### Strukturaudit
- [PASS/WARN/FAIL] Verzeichnisstruktur
- [PASS/WARN/FAIL] Dateigröße
- [PASS/WARN/FAIL] Ebenentiefe

### Inhaltsaudit
- [PASS/WARN/FAIL] Beschreibungsweise
- [PASS/WARN/FAIL] Erkennung modellbekannter Inhalte
- [PASS/WARN/FAIL] Signaldichte

### Versionsverwaltung
- [PASS/WARN/FAIL] Versionsnummernformat
- [PASS/WARN/FAIL] Synchronisationsstatus

### Gesamtpunktzahl: {X}/100
### Empfehlungen: {priorisierte Aktionen}

Anti-Pattern-Erkennungscheckliste

Strukturelle Anti-Pattern

• Einzeldatei-Aufblähung (> 50KB)
• Beschreibung zu lang (> 100 Tokens)
• Keine Hierarchie (> 50 Themen nebeneinander)
• Keine Versionsverwaltung

Inhaltliche Anti-Pattern

• Modellbekannte Inhalte (Erklärung grundlegender Konzepte)
• Über-Engineering (Abstraktionsebene > tatsächlicher Bedarf)
• Prozessaufführung (Einhaltung von Beschränkungen statt Endproduktqualität)
• Keine Überprüfungsstandards

Yinyo-spezifische Fallstricke

• Zögern bei Versionsrücksetzungen (bei Qualitätsminderung nicht sofort zurücksetzen)
• Je vollständiger der Prozess, desto schlechter die Qualität (Lehre aus yinyo-writer)
• Einzeldatei 277KB (Lehre aus yinyo-liuyao)

Reparaturvorschlagsvorlagen

Einzeldatei-Aufblähung → Aufteilung

Alt: SKILL.md (277KB)
Neu:
├── SKILL.md (5KB: Kernregeln)
├── docs/
│   ├── rules.md (50KB: 120 Regeln)
│   ├── examples.md (100KB: 412 Beispiele)
│   └── reference.md (30KB: 64 Hexagramm-Najia-Tabelle)
└── subskills/
    ├── edge-case-1.md
    └── edge-case-2.md

Falsche Beschreibung → Korrektur

❌ "This Skill helps you write articles."
✅ "Load when the user needs to write a WeChat public account article."

Schnellreferenz

Skill-Benennung

yinyo-{domain}-{action}

Dateigrößen

• Index: < 1KB
• Body: < 50KB
• Runtime: Keine Obergrenze

Versionsverwaltung

• SemVer: MAJOR.MINOR.PATCH
• Jedes Update synchronisieren: SKILL.md + README.md + Git commit + Speicher

Reparatur-Trigger-Wörter

• "Repariere dieses Skill" → Interaktiver Reparaturmodus
• "Automatische Reparatur" → Führt Reparaturen mit niedrigem Risiko aus
• "Hilf mir zu ändern" → Zeigt Änderungsvorschläge an, wartet auf Bestätigung