Zum Inhalt springen
Olivares AI docs

Skills — der immutable Katalog und die gepinnten Zuweisungen

Skills (modules/skills, olivares.skills) ist eines der 32 Module. Es besitzt den immutableen Skills-Katalog und seine gepinnten Zuweisungen: Ein Skill-Pack wird einmal installiert, Eintrag für Eintrag gegen seinen Manifest-Digest validiert und als immutable Revision veröffentlicht — danach wird es nie an Ort und Stelle editiert. Was ein Ziel (ein Agent, eine Gruppe, ein Workspace) nutzen darf, ist eine Zuweisung, die eine Pack-Revision pinnt, und jeder Pin wird ins Audit-Ledger geschrieben (skills.assignment.pin).

Bei neuen Installationen standardmäßig aktiviert bleibt Skills optional und benötigt kein anderes Modul. Upgrades behalten die gespeicherte Modulauswahl bei. Unter Skills (/skills) können Sie integrierte Pakete installieren und optional einem Arbeitsbereich zuweisen oder Aus Git wählen. Die CLI verwendet denselben unveränderlichen, per Digest geprüften Import:

Terminal-Fenster
olivares skills ls --builtin
olivares skills install --builtin ecc-security
olivares skills install --git https://github.com/owner/skills --ref <commit> --subdir skills
olivares skills assign <pack-id> --revision <revision-id> --workspace <workspace-id>
olivares skills update <pack-id>                       # read the recorded source again and review the diff
olivares skills update <pack-id> --apply --expected-digest <digest>
olivares skills pin <pack-id> [--revision <older-revision-id>]
olivares skills enable tdd-workflow code-review --folder <folder-ref>
olivares skills selection --workspace <workspace-id> --folder <folder-ref>

Was es liefert

Abschnitt betitelt „Was es liefert“
  • Der Katalog. Installierte Packs unter /v1/m/skills/packs, jede unveränderliche Revision speichert ihren Manifest-Digest; ein Pack, das noch zugewiesen oder von aufgezeichneten Konversationen genutzt wird, zu retirieren wird verweigert, nicht still kaskadiert gelöscht.
  • Der eingebaute Katalog. Ein mitgeliefertes Set upstreamer Skill-Packs, per Commit und Archiv-Digest gepinnt (builtin/PIN.json), bei der Installation exakt wie ein hochgeladenes Archiv validiert. Nichts davon läuft bei der Installation.
  • Die Zuweisungen. GET/POST /v1/m/skills/assignments und PUT/DELETE /v1/m/skills/assignments/{id} pinnen eine Revision an ein Ziel, im Scope des aktiven Workspace. Zwei Ziele derselben Art, die unter einem Skill-Namen unterschiedlichen Inhalt pinnen, werden vor Sitzungsstart verweigert; ein engeres Ziel (Ordner, Vorlage, Agent, Sitzung) ersetzt den gleichnamigen Skill eines weiteren Ziels, sodass ein Projekt ein generisches Pack überschreibt, ohne es zu ändern.
  • Git-Import. Ein operator-scoped Importer kann ein Skill-Pack aus einer Git-Quelle unter einer gepinnten Policy holen; der Import landet als weitere immutable Revision im Katalog, nicht als Live-Checkout, den das Engine liest.

Oberflächen und Berechtigungen

Abschnitt betitelt „Oberflächen und Berechtigungen“

Die Routen des Moduls leben in seinem Beta-Namespace (/v1/m/skills/…), dokumentiert in der Modul-Routen-Referenz und gerendert in der Skills-Ansicht der Konsole. Lesevorgänge brauchen die Read-Berechtigung; ein Pack oder eine Revision zu installieren braucht Write; Retirieren braucht Admin; Zuweisungen brauchen die Assign-Berechtigung. Eine Session löst ihre Skills nur über registrierte Zuweisungen auf — ein Ordner, der sich auf der Festplatte ändert, ändert nie, was ein bereits gepinnter Launch ausführen wird.

Verwandtes

Abschnitt betitelt „Verwandtes“