Zum Inhalt springen

Den eigenen Skill exportieren

Importieren ist der halbe Kreislauf. Die andere Hälfte: Was dich das Bauen von 4Notice gelehrt hat, geht zurück in ein Repo, das dir gehört — dein Speccify-Work-Repo —, verfügbar für jedes folgende Projekt. Dieses Kapitel setzt dieses Repo auf.

Ein privates GitHub-Repo, ein Verzeichnis pro Skill-Bundle:

dein-skills-repo/
└── skills/
├── macos-notarize-tauri/
│ ├── SKILL.md
│ └── tools/
│ └── verify-signatures/
│ ├── TOOL.md
│ └── fixtures/…
└── release-checks/
├── SKILL.md
└── tools/…
Terminal-Fenster
gh repo create dein-skills-repo --private

Bundles enthalten Tool-Specs, keine Implementierungen — Verträge wandern, Skripte nicht (warum). Ein reference.py pro Tool ist als durchgerechnetes Beispiel für eine Plattform in Ordnung; die Wahrheit bleibt der Spec.

Versionen sind Git-Tags, einer pro Bundle: skills/<name>/v1.0.0. Zwei Regeln aus der Praxis:

  • Tags sind endgültig. Die Versionsauflösung wählt den niedrigsten Tag, der einen Bereich erfüllt — ein kaputtes v1.0.0, das stehen bleibt, würde für immer gewählt. Ein Fehler heißt: neuer Tag und den kaputten löschen (solange ihn niemand gelockt hat) — nie am selben Tag neu taggen.
  • Geschwister-Skills innerhalb derselben Quelle referenzieren (ein uses-Link auf git+…#skills/<anderer>@^1.0), damit ein Bundle auflöst, egal von wo es konsumiert wird.

Vor dem Pushen validieren:

Terminal-Fenster
speccify check # jedes Bundle: Frontmatter, Specs, Beispiele

Der Abnahmetest für dein Repo ist der Import, den du schon kennst: In einem leeren Scratch-Ordner eines deiner Bundles per git+…#skills/<name>-Id adden, expandieren, und zusehen, wie normale Skills und Tool-Verträge unter .agent/ erscheinen — genau die Import-Erfahrung, die 4Notice hatte, jetzt aus deinem Repo serviert.

Die Form des Zugs ist aus dem Import-Kapitel rückwärts schon klar: Projektspezifisches in einen ## In this project-artigen Schluss abstreifen (es bleibt zurück), teuer Gelerntes zu Pitfalls machen, jedem Schritt eine Verify:-Zeile geben, und Tools einen Vertrag mit Beispielen — denn dein nächstes Projekt wird dem Check vertrauen, nicht deinem Gedächtnis.