Skills für Unternehmen

Diese Anleitung richtet sich an Unternehmensadministratoren und Architekten, die Agent Skills in einer Organisation verwalten müssen. Sie behandelt, wie Sie Skills in großem Maßstab überprüfen, evaluieren, bereitstellen und verwalten. Weitere Informationen zur Erstellung finden Sie unter Best Practices. Weitere Architekturdetails finden Sie in der Skills-Übersicht.

Sicherheitsprüfung und Überprüfung

Die Bereitstellung von Skills in einem Unternehmen erfordert die Beantwortung von zwei unterschiedlichen Fragen:

1. Sind Skills grundsätzlich sicher? Weitere Informationen finden Sie im Abschnitt Sicherheitsaspekte in der Übersicht für Details zur Sicherheit auf Plattformebene.
2. Wie überprüfe ich einen bestimmten Skill? Verwenden Sie die Risikobewertung und die Überprüfungscheckliste unten.

Risikostufenbewertung

Evaluieren Sie jeden Skill anhand dieser Risikoindikatoren, bevor Sie die Bereitstellung genehmigen:

Überprüfungscheckliste

Bevor Sie einen Skill von einem Drittanbieter oder internen Mitwirkenden bereitstellen, führen Sie diese Schritte aus:

1. Lesen Sie den gesamten Skill-Verzeichnisinhalt. Überprüfen Sie SKILL.md, alle referenzierten Markdown-Dateien und alle gebündelten Skripte oder Ressourcen.
2. Überprüfen Sie, dass das Skriptverhalten dem angegebenen Zweck entspricht. Führen Sie Skripte in einer isolierten Umgebung aus und bestätigen Sie, dass die Ausgaben mit der Beschreibung des Skills übereinstimmen.
3. Überprüfen Sie auf gegnerische Anweisungen. Suchen Sie nach Direktiven, die Claude anweisen, Sicherheitsregeln zu ignorieren, Aktionen vor Benutzern zu verbergen, Daten durch Antworten zu exfiltrieren oder das Verhalten basierend auf bestimmten Eingaben zu ändern.
4. Überprüfen Sie auf externe URL-Abrufe oder Netzwerkaufrufe. Durchsuchen Sie Skripte und Anweisungen nach Netzwerkzugriffsmustern (http, requests.get, urllib, curl, fetch).
5. Überprüfen Sie, dass keine hartcodierten Anmeldedaten vorhanden sind. Überprüfen Sie Skill-Dateien auf API-Schlüssel, Token oder Passwörter. Anmeldedaten sollten Umgebungsvariablen oder sichere Anmeldedatenspeicher verwenden und niemals in Skill-Inhalten angezeigt werden.
6. Identifizieren Sie Tools und Befehle, die der Skill Claude anweist, aufzurufen. Listen Sie alle Bash-Befehle, Dateivorgänge und Tool-Referenzen auf. Berücksichtigen Sie das kombinierte Risiko, wenn ein Skill sowohl Datei-Lese- als auch Netzwerk-Tools zusammen verwendet.
7. Bestätigen Sie Umleitungsziele. Wenn der Skill auf externe URLs verweist, überprüfen Sie, dass sie auf erwartete Domänen verweisen.
8. Überprüfen Sie auf keine Datenexfiltrationsmuster. Suchen Sie nach Anweisungen, die sensible Daten lesen und diese dann für externe Übertragung schreiben, senden oder codieren, einschließlich durch Claudes Gesprächsantworten.

Evaluierung von Skills vor der Bereitstellung

Skills können die Agent-Leistung beeinträchtigen, wenn sie falsch ausgelöst werden, mit anderen Skills in Konflikt geraten oder schlechte Anweisungen bieten. Fordern Sie eine Evaluierung vor jeder Produktionsbereitstellung an.

Was zu evaluieren ist

Richten Sie Genehmigungsgates für diese Dimensionen ein, bevor Sie einen Skill bereitstellen:

Evaluierungsanforderungen

Fordern Sie von Skill-Autoren ein, dass sie Evaluierungssuites mit 3-5 repräsentativen Abfragen pro Skill einreichen, die Fälle abdecken, in denen der Skill ausgelöst werden sollte, nicht ausgelöst werden sollte und mehrdeutige Grenzfälle. Fordern Sie Tests über die Modelle an, die Ihre Organisation verwendet (Haiku, Sonnet, Opus), da die Skill-Effektivität je nach Modell variiert.

Detaillierte Anleitung zum Erstellen von Evaluierungen finden Sie unter Evaluierung und Iteration in Best Practices. Allgemeine Evaluierungsmethodik finden Sie unter Testfälle entwickeln.

Verwendung von Evaluierungen für Lebenszyklusentscheidungen

Evaluierungsergebnisse signalisieren, wann Maßnahmen erforderlich sind:

• Sinkende Auslösegenauigkeit: Aktualisieren Sie die Beschreibung oder Anweisungen des Skills
• Koexistenzkonflikt: Konsolidieren Sie überlappende Skills oder verengen Sie Beschreibungen
• Konsistent niedrige Ausgabequalität: Schreiben Sie Anweisungen um oder fügen Sie Validierungsschritte hinzu
• Anhaltende Fehler über Updates hinweg: Veralten Sie den Skill

Skill-Lebenszyklusverwaltung

Organisation von Skills im großen Maßstab

Abrufgrenzen

Begrenzen Sie als allgemeine Richtlinie die Anzahl der gleichzeitig geladenen Skills, um eine zuverlässige Abrufgenauigkeit zu gewährleisten. Die Metadaten jedes Skills (Name und Beschreibung) konkurrieren um Aufmerksamkeit in der Systemaufforderung. Bei zu vielen aktiven Skills kann Claude möglicherweise den richtigen Skill nicht auswählen oder relevante ganz übersehen. Verwenden Sie Ihre Evaluierungssuite, um die Abrufgenauigkeit zu messen, wenn Sie Skills hinzufügen, und hören Sie auf zu addieren, wenn die Leistung sinkt.

Beachten Sie, dass API-Anfragen maximal 8 Skills pro Anfrage unterstützen (siehe Verwendung von Skills mit der API). Wenn eine Rolle mehr Skills benötigt, als eine einzelne Anfrage unterstützt, erwägen Sie, enge Skills in breitere zu konsolidieren oder Anfragen basierend auf dem Aufgabentyp an verschiedene Skill-Sätze weiterzuleiten.

Beginnen Sie spezifisch, konsolidieren Sie später

Ermutigen Sie Teams, mit engen, workflow-spezifischen Skills zu beginnen, anstatt mit breiten, mehrzweckigen. Wenn Muster in Ihrer Organisation entstehen, konsolidieren Sie verwandte Skills in rollenbasierte Bündel.

Beispielfortschritt:

• Start: formatting-sales-reports, querying-pipeline-data, updating-crm-records
• Konsolidieren: sales-operations (wenn Evaluierungen gleichwertige Leistung bestätigen)

Benennung und Katalogisierung

Verwenden Sie konsistente Benennungskonventionen in Ihrer Organisation. Der Abschnitt Benennungskonventionen in Best Practices bietet Formatierungsanleitung.

Führen Sie eine interne Registrierung für jeden Skill mit:

• Zweck: Welcher Workflow wird vom Skill unterstützt
• Besitzer: Team oder Person, die für die Wartung verantwortlich ist
• Version: Aktuell bereitgestellte Version
• Abhängigkeiten: MCP-Server, Pakete oder erforderliche externe Dienste
• Evaluierungsstatus: Letztes Evaluierungsdatum und Ergebnisse

Rollenbasierte Bündel

Gruppieren Sie Skills nach organisatorischer Rolle, um den aktiven Skill-Satz jedes Benutzers fokussiert zu halten:

• Vertriebsteam: CRM-Vorgänge, Pipeline-Berichterstattung, Angebotsgeneration
• Engineering: Code-Überprüfung, Bereitstellungs-Workflows, Incident Response
• Finanzen: Berichtsgenerierung, Datenvalidierung, Audit-Vorbereitung

Jedes rollenbasierte Bündel sollte nur die Skills enthalten, die für die täglichen Workflows dieser Rolle relevant sind.

Verteilung und Versionskontrolle

Quellkontrolle

Speichern Sie Skill-Verzeichnisse in Git für Verlaufsverfolgung, Code-Überprüfung über Pull Requests und Rollback-Fähigkeit. Jedes Skill-Verzeichnis (mit SKILL.md und allen gebündelten Dateien) wird natürlich einem Git-verfolgten Ordner zugeordnet.

API-basierte Verteilung

Die Skills API bietet arbeitsbereichsbegrenzte Verteilung. Skills, die über die API hochgeladen werden, sind für alle Workspace-Mitglieder verfügbar. Weitere Informationen finden Sie unter Verwendung von Skills mit der API für Upload-, Versions- und Verwaltungsendpunkte.

Versionierungsstrategie

• Produktion: Heften Sie Skills an spezifische Versionen. Führen Sie die vollständige Evaluierungssuite aus, bevor Sie eine neue Version fördern. Behandeln Sie jedes Update als eine neue Bereitstellung, die eine vollständige Sicherheitsprüfung erfordert.
• Entwicklung und Tests: Verwenden Sie die neuesten Versionen, um Änderungen vor der Produktionsförderung zu validieren.
• Rollback-Plan: Behalten Sie die vorherige Version als Fallback. Wenn eine neue Version die Evaluierungen in der Produktion nicht besteht, kehren Sie sofort zur letzten bekannten guten Version zurück.
• Integritätsprüfung: Berechnen Sie Prüfsummen überprüfter Skills und überprüfen Sie diese zum Bereitstellungszeitpunkt. Verwenden Sie signierte Commits in Ihrem Skill-Repository, um die Herkunft sicherzustellen.

Überlegungen zu mehreren Oberflächen

Führen Sie Skill-Quelldateien in Git als einzelne Quelle der Wahrheit. Wenn Ihre Organisation Skills über mehrere Oberflächen bereitstellt, implementieren Sie Ihren eigenen Synchronisierungsprozess, um sie konsistent zu halten. Vollständige Details finden Sie unter Verfügbarkeit über mehrere Oberflächen.

Nächste Schritte