CommunityCodierung & Entwicklunggithub.com

skillgram-Meldung

Melde einen skillgram-Fehler oder eine fehlende Skill-Lücke mit echten Beweisen: Wähle den Kanal, erfasse das JSON, öffne das Issue.

Was ist skillgram-Meldung?

Dieses Skill ermöglicht es Nutzern, Fehler im skillgram-Tool oder fehlende Skills systematisch und evidenzbasiert zu melden. Es unterstützt zwei Kanäle: Bug-Meldungen für technische Fehler (z.B. `ok:false`, Abstürze, falsche Links) und Skill-Anfragen für Fähigkeiten, die `found:false` zurückgeben. Der Skill stellt sicher, dass keine erfundenen Beweise verwendet werden – jeder Exit-Code, jeder Pfad und jede JSON-Zeile stammt aus aktuell ausgeführten Befehlen. Er arbeitet plattformübergreifend mit gängigen Harness-Controllern (z.B. Claude Code, Cursor, Codex) und erzeugt Issues direkt über `gh issue create` mit den passenden Vorlagen (`bug_report.yml` oder `skill_request.yml`). Besonders wichtig: Der Skill verbietet das manuelle Editieren von Harness-Konfigurationen, um Fehler zu kaschieren, und verlangt das Auslesen der Konfiguration als zusätzlichen Nachweis.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Xhuk/skillgram/tree/HEAD/skills/skillgram-report

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation


name: skillgram-meldung description: Melde einen skillgram-Fehler oder eine fehlende Skill-Lücke mit echten Beweisen: Wähle den Kanal, erfasse das JSON, öffne das Issue.

Was macht skillgram-Meldung?

Aktivierungsvertrag

Verwende diesen Skill, wenn einer der folgenden Punkte zutrifft:

  • skillgram gibt ok:false aus, beendet sich mit Exit-Code 1/2, stürzt ab oder sagt etwas, das der Festplatte widerspricht (registered ohne Eintrag in der Harness-Konfiguration, ein Link, der ins Leere führt, ein Mount, der null Skills meldet, obwohl das Manifest welche enthält).
  • Ein Agent benötigte eine Fähigkeit und skillgram missing "<Abfrage>" antwortete found:false.
  • Eine Installation oder Registrierung wurde nach dem dokumentierten Neustart nicht im Harness wirksam.

Nicht für: „Wie führe ich X aus?“ (lies INSTALL.md) oder eine Feature-Idee ohne beobachtete Lücke.

Harte Regeln

  1. Ein Fehler wird niemals als Skill gemeldet. Führe niemals propose aus, um fehlerhaftes Verhalten zu überdecken.
  2. Eine Lücke wird niemals als Fehler gemeldet. Fehlt eine Fähigkeit im Hub, ist das eine Anfrage.
  3. Keine erfundenen Beweise: Jeder Exit-Code, Pfad und jede JSON-Zeile stammt von einem Befehl, den du jetzt ausgeführt hast.
  4. Vor dem Einfügen schwärzen: Token, Passwörter, private Hosts, Kundennamen. Behalte die Struktur, ändere die Werte.
  5. Repariere skillgram niemals durch manuelles Bearbeiten einer Harness-Konfiguration (config.toml, config.yaml, .claude.json, .cursor/mcp.json). Das verbirgt den Fehler.
  6. Lies die Konfiguration zurück, bevor du einen Erfolg behauptest: <Harness> mcp get skillgram (oder mcp list) und skillgram status. Ein Exit-Code ist kein Beweis.

Entscheidungsgatter

BeobachtungKanal
ok:false, Exit-Code ungleich null, falscher Link, Lüge in der Ausgabe, AbsturzFehler → bug_report.yml
found:false für eine tatsächlich benötigte FähigkeitSkill-Anfrage → skill_request.yml
Das Fehlende ist ein skillgram-Befehl, Flag oder Verhalten, kein SkillFehler (schreibe „Feature“ in den Titel)
Funktioniert auf einem anderen Rechner oder Harnessals Beweis notieren; es ist keine Lösung
UnsicherSammle beide Beweise und lass den Nutzer den Kanal wählen

Ausführungsschritte

  1. Reproduziere einmal und behalte die exakte Befehlszeile. Verwende die CLI (skillgram <Befehl> --json, oder python <Repo>/skillgram.py <Befehl> --json wenn es nicht installiert ist) und notiere den Exit-Code ($LASTEXITCODE unter PowerShell, $? unter POSIX).
  2. Erfasse die Umgebung:
    • skillgram status --json
    • skillgram doctor --json (schreibgeschützt; entferne Pfade, die du nicht öffentlich machen möchtest)
    • Betriebssystem, Python-Version, skillgram-Version, das Harness und den Launcher, den du verwendet hast (SKILLGRAM_MCP_CLI_<HARNESS> wenn der in PATH nicht der richtige ist).
  3. Bei einer Registrierungsbehauptung erfasse <Harness> mcp get skillgram (oder mcp list) nach dem Befehl, der den Erfolg behauptet hat.
  4. Bei einer Lücke erfasse skillgram missing "<Abfrage>" --json und skillgram demand --limit 20 (es sortiert die Anfragen, die niemand beantworten konnte, sodass das Issue und das Demand-Log übereinstimmen).
  5. Verfasse das Issue aus der Vorlage und zeige es dem Nutzer vor dem Posten. Poste mit gh issue create --repo Xhuk/skillgram --template bug_report.yml (oder --body-file <Datei> wenn du das Formular selbst ausfüllst) oder übergib den Text.

Ausgabevertrag

Antworte genau mit:

  • Kanal: bug oder skill-request
  • Beweise: der Befehl, der Exit-Code, eine JSON-Zeile
  • Umgebung: Betriebssystem / Python / skillgram / Harness / Launcher
  • Erwartet stattdessen: ein Satz, keine Spekulation
  • Status: gepostet (mit der Issue-URL) oder als Text für den Nutzer hinterlassen

Verwandte Skills