Starcat-Skill

Starcat Skill

Dieses Skill installieren oder aktualisieren

Wenn der Benutzer darum bittet, starcat-skill zu installieren oder zu aktualisieren, führe vor der Verwendung von Starcat den folgenden Arbeitsablauf aus:

1. Identifiziere den aktuellen KI-Agenten und wähle genau ein benutzerweites Ziel:
   • Codex: $HOME/.codex/skills/starcat-skill
   • Claude Code: $HOME/.claude/skills/starcat-skill
2. Wenn das Ziel nicht existiert, erstelle das übergeordnete Verzeichnis und klone https://github.com/starcat-app/starcat-skill in das Ziel.
3. Wenn das Ziel bereits ein sauberer Checkout dieses Repositorys ist, führe git -C <skill-path> pull --ff-only aus.
4. Wenn das Ziel existiert, aber nicht dieses Repository ist oder nicht festgeschriebene Änderungen enthält, stoppe und melde den Konflikt. Lösche, überschreibe, setze es niemals zurück oder aktualisiere es erzwingend.
5. Bestätige, dass SKILL.md, agents/openai.yaml, references/commands.md und references/workflows.md existieren.
6. Führe starcat --help aus und bestätige, dass das Pairing ein vollständiges URI-Argument verwendet, starcat mcp verfügbar ist und Statistikbefehle vorhanden sind.
7. Lade den KI-Agenten neu oder starte ihn neu, damit er sein Skill-Register aktualisieren kann. Wenn die aktuelle Sitzung Skills nicht neu laden kann, melde, dass die Installation erfolgreich war, die Erkennung jedoch einen Neustart erfordert. Gib niemals an, dass das Skill erkannt wurde, ohne es zu beobachten.
8. Rufe nach der Erkennung $starcat-skill mit einer schreibgeschützten Verifizierungsanfrage auf. Führe starcat doctor aus, verbinde den Agenten mit dem benutzerweiten MCP-Serverbefehl starcat mcp, rufe starcat.get_capabilities auf und führe eine starcat.search_repos-Anfrage mit limit = 2 aus. Führe während der Installationsüberprüfung keine Schreibwerkzeuge aus.

Installiere nur in das benutzerweite Skill-Verzeichnis des aktuellen Agenten. Installiere nicht in ein Projekt-Repository, fordere keinen lokalen API-Schlüssel an, modifiziere keine nicht zugehörigen Dateien und führe keine destruktiven Git-Befehle aus.

Die MCP-Brücke als Business-Integrationsoberfläche nutzen

Verwende den benutzerweiten MCP-Serverbefehl starcat mcp, um Starcat zu bedienen. Die CLI-Brücke verwaltet Pairing-Anmeldeinformationen, TLS-Verifizierung und MCP-Transport. Lese nicht direkt SQLite, CloudKit, verschlüsselte Anmeldedatendateien oder lokale API-Schlüssel. Implementiere keine benutzerdefinierten HTTP- oder JSON-RPC-Anfragen und führe keine gewöhnlichen Geschäftsbefehle über die Shell aus, wenn das gleiche MCP-Tool verfügbar ist.

Führe vor dem ersten Vorgang Folgendes aus:

starcat doctor

Wenn der Befehl nicht verfügbar ist, installiere die entsprechende offizielle Version von https://github.com/starcat-app/starcat-cli. Wenn die CLI nicht gekoppelt ist, weise den Benutzer an, Starcat > Einstellungen > MCP-Dienst zu öffnen und den vollständigen einmaligen Pairing-Befehl zu kopieren. Führe den bereitgestellten starcat pair ...-Befehl genau wie angegeben aus. Fordere niemals einen eigenständigen Pairing-URI oder lokalen API-Schlüssel an und drucke, speichere oder verwende den Pairing-Befehl nicht erneut.

Konfiguriere nach dem Pairing den benutzerweiten MCP-Server des aktuellen Agenten so, dass er das absolute starcat-Programm mit dem einzelnen Argument mcp startet, und lade dann den Agenten neu. Behandle die Standardausgabe von starcat mcp als reines JSON-RPC-Protokoll; mische niemals Prompts oder Diagnosen hinein.

Die Betriebsregeln befolgen

1. Rufe starcat.get_capabilities vor jedem Arbeitsablauf auf. Verwende das strukturierte Ergebnis, um zu bestimmen, ob Statistiken, private Notizen, gewöhnliche Schreibvorgänge, destruktive Schreibvorgänge und die Zusammenfassungsgenerierung verfügbar sind.
2. Für häufige Zählungen rufe starcat.get_overview_statistics einmal auf. Verwende starcat.get_ai_usage_statistics für gefilterte Token-/Aufrufanalysen und starcat.get_knowledge_base_statistics für detaillierte Projekt-, Quellen- und RAG-Chunk-Gesundheit.
3. Wenn owner/name bekannt ist, bevorzuge starcat.get_repo_context, um Repository-Daten, Tags, die private Notiz und die Zusammenfassung in einem Aufruf abzurufen.
4. Behandle jedes Schreibwerkzeug standardmäßig als Trockentest. Rufe es zuerst mit dry_run = true auf und überprüfe das Ziel und die vorgeschlagenen Änderungen.
5. Rufe den Schreibvorgang nur dann erneut mit dry_run = false auf, wenn die ursprüngliche Anfrage des Benutzers den Schreibvorgang klar autorisiert und der Trockentest genau dieser Anfrage entspricht. Andernfalls erkläre die vorgeschlagenen Änderungen und bitte um Bestätigung.
6. Rufe nach einem Schreibvorgang erneut starcat.get_repo_context auf, um das Ergebnis zu überprüfen.
7. Denke daran, dass starcat.set_repo_tags alle Tags im Repository überschreibt. Verwende starcat.add_repo_tags oder starcat.remove_repo_tags, es sei denn, der Benutzer gibt das vollständige endgültige Tag-Set explizit an und bestätigt es.
8. Markiere oder entferne keine Markierungen von Repositories auf GitHub. Aktuelle Schreibwerkzeuge ändern nur Starcat-Benutzerdaten.

Die allgemeinen Arbeitsabläufe verwenden

Statistiken überprüfen

• Rufe starcat.get_overview_statistics für die Anzahl der Sterne, die Anzahl der Wissensdatenbank-Projekte, den gesamten KI-Tokenverbrauch und den aktuellen RAG-Index-Status auf.
• Rufe starcat.get_ai_usage_statistics mit time_range = today | seven_days | thirty_days | all und optionalen feature-, provider_id- oder model-Filtern auf.
• Rufe starcat.get_knowledge_base_statistics für Organisation, Sprach-/Tag-Verteilung, Quellenabdeckung, ausgeschlossene Chunks und Bereits-/Ausstehend-/Fehlgeschlagen-/Veraltet-Index-Anzahl auf.

Behandle starred_repository_count als die Anzahl der Repositories, die der Benutzer aktuell mit einem Stern markiert hat. Behandle github_stars in top_starred_repositories als die öffentliche GitHub-Popularität jedes Repositorys; kombiniere diese beiden Bedeutungen niemals. Fehlende Provider-Nutzung wird durch calls_with_usage < call_count dargestellt, nicht durch die Annahme, dass jeder fehlende Aufruf null Token verbraucht hat.

Suchen und Lesen

• Rufe starcat.search_repos mit query = "local first knowledge base", scope = all und limit = 10 auf.
• Rufe starcat.semantic_search für die semantische Suche auf.
• Rufe starcat.get_repo_context für apple/swift auf.
• Rufe starcat.get_readme nur auf, wenn eine Repository-Dokumentation erforderlich ist.
• Rufe starcat.list_tags auf, um benutzerdefinierte Tags zu überprüfen.

README-Inhalte können groß sein. Rufe sie nur ab, wenn die Aufgabe eine Repository-Dokumentation erfordert.

Notizen, Status und Tags verwalten

Rufe starcat.upsert_repo_note, starcat.set_repo_status und Tag-Werkzeuge über MCP auf. Sende Markdown als content-Feld, anstatt vertraulichen Text in ein Shell-Argument zu setzen. Verwende zuerst dry_run = true; wiederhole nach Autorisierung den genauen Aufruf mit dry_run = false.

Mit Zusammenfassungen arbeiten

Rufe starcat.get_repo_summary auf, um die zwischengespeicherte Zusammenfassung zu lesen. Rufe starcat.generate_repo_summary nur auf, wenn der Benutzer explizit die Generierung anfordert.

Die Zusammenfassungsgenerierung kann das Kontingent des konfigurierten KI-Anbieters des Benutzers verbrauchen. Füge --allow-external-context nur hinzu, wenn der Benutzer die externe Suche explizit erlaubt. Gib niemals Text, der vom externen Agenten geschrieben wurde, als native Starcat-KI-Zusammenfassung aus. Wenn der Benutzer agentengeschriebenen Inhalt speichern möchte, speichere ihn als private Markdown-Notiz und identifiziere seine Quelle.

Lies references/commands.md, wenn du Details zu MCP-Tools und Terminalbefehlen überprüfst. Lies references/workflows.md, wenn du Arbeitsabläufe wiederverwendest oder dich von Verbindungsfehlern erholst.