Communitygithub.com

charlieviettq/awesome-agent-skill

Schreibgeschütztes Queue-Dashboard für workspace-bewussten Ship-Prozess (gstack).

Was ist awesome-agent-skill?

Diese Fähigkeit (Skill) bietet ein schreibgeschütztes Dashboard für den Versions-Queue („landing report“) im Kontext des gstack-Workflows. Sie zeigt an, welche VERSION-Slots von offenen PRs belegt sind, welche Conductor-Workspaces kurz vor dem Ship stehen und welchen Slot der nächste `/ship`-Befehl auswählen würde. Der Skill führt keine Mutationen durch, sondern erstellt eine Momentaufnahme des aktuellen Zustands. Er unterstützt Claude Code und ähnliche Plattformen (z. B. Codex) und wird typischerweise auf Anfragen wie „Landing Report“, „Was ist in der Queue?“, „Zeige offene PRs“ oder „Welche Version claim ich als nächstes?“ aktiviert. Der Skill führt vorab umfangreiche Umgebungsprüfungen durch (z. B. Branch-Name, Session-Typ, Konfigurationseinstellungen), protokolliert die Nutzung und bietet Onboarding-Abläufe für neue Benutzer (z. B. Ersteinrichtungs-Tipps, Telemetrie-Opt-in, proaktive Vorschläge). Er arbeitet im Plan-Modus sicher und respektiert Konfigurationsoptionen wie `proactive` und `skill_prefix`.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/charlieviettq/awesome-agent-skill/tree/HEAD/.claude/skills/gstack-landing-report

In Ihrer bevorzugten KI fragen

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

Dokumentation

Wann dieser Skill aufgerufen werden sollte

Zeigt an, welche VERSION-Slots derzeit von offenen PRs belegt sind, welche Conductor-Workspaces WIP-Arbeit enthalten, die wahrscheinlich bald ausgeliefert wird, und welchen Slot /ship als nächstes auswählen würde. Keine Mutationen – nur eine Momentaufnahme. Verwenden, wenn nach "Landing Report", "Was ist in der Queue?", "Zeige offene PRs" oder "Welche Version claim ich als nächstes?" gefragt wird.

/landing-report — Versions-Queue-Dashboard

Präambel (zuerst ausführen)

_UPD=$(~/.claude/skills/gstack/bin/gstack-update-check 2>/dev/null || .claude/skills/gstack/bin/gstack-update-check 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true
mkdir -p ~/.gstack/sessions
touch ~/.gstack/sessions/"$PPID"
_SESSIONS=$(find ~/.gstack/sessions -mmin -120 -type f 2>/dev/null | wc -l | tr -d ' ')
find ~/.gstack/sessions -mmin +120 -type f -exec rm {} + 2>/dev/null || true
_PROACTIVE=$(~/.claude/skills/gstack/bin/gstack-config get proactive 2>/dev/null || echo "true")
_PROACTIVE_PROMPTED=$([ -f ~/.gstack/.proactive-prompted ] && echo "yes" || echo "no")
_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
echo "BRANCH: $_BRANCH"
_SKILL_PREFIX=$(~/.claude/skills/gstack/bin/gstack-config get skill_prefix 2>/dev/null || echo "false")
echo "PROACTIVE: $_PROACTIVE"
echo "PROACTIVE_PROMPTED: $_PROACTIVE_PROMPTED"
echo "SKILL_PREFIX: $_SKILL_PREFIX"
source <(~/.claude/skills/gstack/bin/gstack-repo-mode 2>/dev/null) || true
REPO_MODE=${REPO_MODE:-unknown}
echo "REPO_MODE: $REPO_MODE"
_SESSION_KIND=$(~/.claude/skills/gstack/bin/gstack-session-kind 2>/dev/null || echo "interactive")
case "$_SESSION_KIND" in spawned|headless|interactive) ;; *) _SESSION_KIND="interactive" ;; esac
echo "SESSION_KIND: $_SESSION_KIND"
# Conductor host: AskUserQuestion ist hier unzuverlässig (native deaktiviert, MCP
# Variante fehleranfällig), daher rendern Skills Entscheidungen als Prosa, anstatt das
# Tool aufzurufen. Auf !headless beschränkt, sodass ein eval/CI-Lauf INNERHALB von Conductor (GSTACK_HEADLESS)
# immer noch BLOCKIERT, anstatt Prosa ins Leere zu rendern.
if [ "$_SESSION_KIND" != "headless" ] && { [ -n "${CONDUCTOR_WORKSPACE_PATH:-}" ] || [ -n "${CONDUCTOR_PORT:-}" ]; }; then
  echo "CONDUCTOR_SESSION: true"
fi
_ACTIVATED=$([ -f ~/.gstack/.activated ] && echo "yes" || echo "no")
_FIRST_LOOP_SHOWN=$([ -f ~/.gstack/.first-loop-tip-shown ] && echo "yes" || echo "no")
echo "ACTIVATED: $_ACTIVATED"
echo "FIRST_LOOP_SHOWN: $_FIRST_LOOP_SHOWN"
# Erstausführungs-Projekterkennung: Detektor NUR beim ersten Skill-Lauf ausführen
# (ACTIVATED=no, interaktiv), damit er bei allen folgenden Läufen nicht im kritischen Pfad liegt.
_FIRST_TASK=""
if [ "$_ACTIVATED" = "no" ] && [ "$_SESSION_KIND" != "headless" ]; then
  _FIRST_TASK=$(~/.claude/skills/gstack/bin/gstack-first-task-detect 2>/dev/null || true)
fi
echo "FIRST_TASK: $_FIRST_TASK"
_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
echo "LAKE_INTRO: $_LAKE_SEEN"
_TEL=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || true)
_TEL_PROMPTED=$([ -f ~/.gstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
echo "TELEMETRY: ${_TEL:-off}"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
_EXPLAIN_LEVEL=$(~/.claude/skills/gstack/bin/gstack-config get explain_level 2>/dev/null || echo "default")
if [ "$_EXPLAIN_LEVEL" != "default" ] && [ "$_EXPLAIN_LEVEL" != "terse" ]; then _EXPLAIN_LEVEL="default"; fi
echo "EXPLAIN_LEVEL: $_EXPLAIN_LEVEL"
_QUESTION_TUNING=$(~/.claude/skills/gstack/bin/gstack-config get question_tuning 2>/dev/null || echo "false")
echo "QUESTION_TUNING: $_QUESTION_TUNING"
mkdir -p ~/.gstack/analytics
if [ "$_TEL" != "off" ]; then
echo '{"skill":"landing-report","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(_repo=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null | tr -cd 'a-zA-Z0-9._-'); echo "${_repo:-unknown}")'"}'  >> ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true
fi
for _PF in $(find ~/.gstack/analytics -maxdepth 1 -name '.pending-*' 2>/dev/null); do
  if [ -f "$_PF" ]; then
    if [ "$_TEL" != "off" ] && [ -x "~/.claude/skills/gstack/bin/gstack-telemetry-log" ]; then
      ~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id "$_SESSION_ID" 2>/dev/null || true
    fi
    rm -f "$_PF" 2>/dev/null || true
  fi
  break
done
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
_LEARN_FILE="${GSTACK_HOME:-$HOME/.gstack}/projects/${SLUG:-unknown}/learnings.jsonl"
if [ -f "$_LEARN_FILE" ]; then
  _LEARN_COUNT=$(wc -l < "$_LEARN_FILE" 2>/dev/null | tr -d ' ')
  echo "LEARNINGS: $_LEARN_COUNT Einträge geladen"
  if [ "$_LEARN_COUNT" -gt 5 ] 2>/dev/null; then
    ~/.claude/skills/gstack/bin/gstack-learnings-search --limit 3 2>/dev/null || true
  fi
else
  echo "LEARNINGS: 0"
fi
~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"landing-report","event":"gestartet","branch":"'"$_BRANCH"'","session":"'"$_SESSION_ID"'"}' 2>/dev/null &
_HAS_ROUTING="no"
if [ -f CLAUDE.md ] && grep -q "## Skill routing" CLAUDE.md 2>/dev/null; then
  _HAS_ROUTING="yes"
fi
_ROUTING_DECLINED=$(~/.claude/skills/gstack/bin/gstack-config get routing_declined 2>/dev/null || echo "false")
echo "HAS_ROUTING: $_HAS_ROUTING"
echo "ROUTING_DECLINED: $_ROUTING_DECLINED"
_VENDORED="no"
if [ -d ".claude/skills/gstack" ] && [ ! -L ".claude/skills/gstack" ]; then
  if [ -f ".claude/skills/gstack/VERSION" ] || [ -d ".claude/skills/gstack/.git" ]; then
    _VENDORED="yes"
  fi
fi
echo "VENDORED_GSTACK: $_VENDORED"
echo "MODEL_OVERLAY: claude"
_CHECKPOINT_MODE=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
_CHECKPOINT_PUSH=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_push 2>/dev/null || echo "false")
echo "CHECKPOINT_MODE: $_CHECKPOINT_MODE"
echo "CHECKPOINT_PUSH: $_CHECKPOINT_PUSH"
# Plan-Modus-Hinweis für Skills wie /spec, die das Verhalten je nach Plan-Modus-Status ändern.
# Claude Code zeigt den Plan-Modus über System-Erinnerungen an; wir erkennen ihn bestmöglich
# über CLAUDE_PLAN_FILE (vom Harness gesetzt, wenn der Plan-Modus aktiv ist) und
# fallen auf "inaktiv" zurück. Codex-Hosts und Claude-Ausführungsmodus enden beide als
# inaktiv, was der sichere Standard ist (Standard ist Datei+Execute-Pipeline).
if [ -n "${CLAUDE_PLAN_FILE:-}${GSTACK_PLAN_MODE_FORCE:-}" ]; then
  export GSTACK_PLAN_MODE="active"
elif [ "${GSTACK_PLAN_MODE:-}" = "active" ]; then
  export GSTACK_PLAN_MODE="active"
else
  export GSTACK_PLAN_MODE="inaktiv"
fi
echo "GSTACK_PLAN_MODE: $GSTACK_PLAN_MODE"
[ -n "$OPENCLAW_SESSION" ] && echo "SPAWNED_SESSION: true" || true

Sichere Operationen im Plan-Modus

Im Plan-Modus erlaubt, da sie den Plan unterstützen: $B, $D, codex exec/codex review, Schreibzugriffe auf ~/.gstack/, Schreibzugriffe auf die Plan-Datei und open für generierte Artefakte.

Skill-Aufruf während des Plan-Modus

Wenn der Benutzer einen Skill im Plan-Modus aufruft, hat der Skill Vorrang vor dem generischen Plan-Modus-Verhalten. Behandle die Skill-Datei als ausführbare Anweisungen, nicht als Referenz. Folge ihr Schritt für Schritt ab Schritt 0; die erste AskUserQuestion ist der Workflow, der in den Plan-Modus wechselt, kein Verstoß dagegen. AskUserQuestion (jede Variante – mcp__*__AskUserQuestion oder nativen; siehe "AskUserQuestion-Format → Tool-Auflösung") erfüllt die Plan-Modus-Anforderung für das Ende des Turns. Wenn AskUserQuestion nicht verfügbar ist oder ein Aufruf fehlschlägt, folge dem Fehler-Fallback des AskUserQuestion-Formats: headless → BLOCKED; interactive → der Prosa-Fallback (erfüllt auch das Ende des Turns). An einem STOP-Punkt sofort anhalten. Setze den Workflow nicht fort und rufe ExitPlanMode nicht auf. Befehle, die mit "PLAN MODE EXCEPTION — ALWAYS RUN" markiert sind, werden ausgeführt. Rufe ExitPlanMode erst auf, nachdem der Skill-Workflow abgeschlossen ist, oder wenn der Benutzer dir sagt, den Skill abzubrechen oder den Plan-Modus zu verlassen.

Wenn PROACTIVE "false" ist, Skills nicht automatisch aufrufen oder proaktiv vorschlagen. Wenn ein Skill nützlich erscheint, frage: "Ich glaube, /skillname könnte hier helfen – soll ich es ausführen?"

Wenn SKILL_PREFIX "true" ist, /gstack-*-Namen vorschlagen/aufrufen. Die Festplattenpfade bleiben ~/.claude/skills/gstack/[skill-name]/SKILL.md.

Wenn die Ausgabe UPGRADE_AVAILABLE <alt> <neu> zeigt: ~/.claude/skills/gstack/gstack-upgrade/SKILL.md lesen und dem "Inline-Upgrade-Ablauf" folgen (automatisches Upgrade, wenn konfiguriert, sonst AskUserQuestion mit 4 Optionen, Snooze-Zustand schreiben, falls abgelehnt).

Wenn die Ausgabe JUST_UPGRADED <von> <nach> zeigt: "Führe gstack v{nach} aus (gerade aktualisiert!)" ausgeben. Wenn SPAWNED_SESSION wahr ist, Feature-Entdeckung überspringen.

Feature-Entdeckung, maximal eine Eingabeaufforderung pro Sitzung:

  • Fehlende ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint: AskUserQuestion für kontinuierliche Checkpoint-Auto-Commits. Bei Annahme ~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous ausführen. Marker immer setzen.
  • Fehlende ~/.claude/skills/gstack/.feature-prompted-model-overlay: informieren "Modell-Overlays sind aktiv. MODEL_OVERLAY zeigt den Patch." Marker immer setzen.

Nach Upgrade-Eingabeaufforderungen Workflow fortsetzen.

Wenn WRITING_STYLE_PENDING yes ist: einmalig nach Schreibstil fragen:

v1-Eingabeaufforderungen sind einfacher: Fachbegriffe beim ersten Gebrauch erklärt, ergebnisorientierte Fragen, kürzere Prosa. Standard beibehalten oder auf knapp zurückstellen?

Optionen:

  • A) Den neuen Standard beibehalten (empfohlen – gute Texte helfen allen)
  • B) V0-Prosa wiederherstellen – explain_level: terse setzen

Bei A: explain_level nicht setzen (Standard ist default). Bei B: ~/.claude/skills/gstack/bin/gstack-config set explain_level terse ausführen.

Immer ausführen (unabhängig von der Wahl):

rm -f ~/.gstack/.writing-style-prompt-pending
touch ~/.gstack/.writing-style-prompted

Überspringen, wenn WRITING_STYLE_PENDING no ist.

Wenn LAKE_INTRO no ist: sagen: "gstack folgt dem Boil the Ocean-Prinzip – die vollständige Sache erledigen, wenn KI die Grenzkosten nahe Null macht. Mehr dazu: https://garryslist.org/posts/boil-the-ocean" Angebot zum Öffnen:

open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen

open nur bei Zustimmung ausführen. touch immer ausführen.

Wenn TEL_PROMPTED no UND LAKE_INTRO yes ist: einmalig nach Telemetrie fragen über AskUserQuestion:

Hilf gstack, besser zu werden. Teile nur Nutzungsdaten: Skill, Dauer, Abstürze, stabile Geräte-ID. Kein Code oder Dateipfade. Dein Repo-Name wird nur lokal aufgezeichnet und vor jedem Hochladen entfernt.

Optionen:

  • A) Hilf gstack, besser zu werden! (empfohlen)
  • B) Nein danke

Bei A: ~/.claude/skills/gstack/bin/gstack-config set telemetry community ausführen

Bei B: nachfragen:

Anonymer Modus sendet nur aggregierte Nutzung, keine eindeutige ID.

Optionen:

  • A) Klar, anonym ist in Ordnung
  • B) Nein danke, komplett aus

Bei B→A: ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous ausführen Bei B→B: ~/.claude/skills/gstack/bin/gstack-config set telemetry off ausführen

Immer ausführen:

touch ~/.gstack/.telemetry-prompted

Überspringen, wenn TEL_PROMPTED yes ist.

Wenn PROACTIVE_PROMPTED no UND TEL_PROMPTED yes ist: einmalig fragen:

Soll gstack proaktiv Skills vorschlagen, z. B. /qa für "Funktioniert das?" oder /investigate für Fehler?

Optionen:

  • A) An lassen (empfohlen)
  • B) Ausschalten – ich gebe /commands selbst ein

Bei A: ~/.claude/skills/gstack/bin/gstack-config set proactive true ausführen Bei B: ~/.claude/skills/gstack/bin/gstack-config set proactive false ausführen

Immer ausführen:

touch ~/.gstack/.proactive-prompted

Überspringen, wenn PROACTIVE_PROMPTED yes ist.

Erstausführungs-Anleitung (einmalig)

Wenn ACTIVATED no ist (erster Skill-Lauf auf diesem Rechner) UND die Präambel einen nicht-leeren FIRST_TASK:-Wert ausgegeben hat, der NICHT nongit ist: EINE kurze, projektspezifische Zeile zeigen, die vom Token abgeleitet ist, als Hinweis, dann MIT DEM FORFAHREN, was der Benutzer tatsächlich gefragt hat – den Task NICHT anhalten. Token-Zuordnung: greenfield → "Frisches Repo – zuerst mit /spec oder /office-hours formen." code_node/code_python/code_rust/code_go/code_ruby/code_ios → "Hier ist Code – /qa, um ihn in Aktion zu sehen, oder /investigate, wenn etwas nicht stimmt." branch_ahead → "Nicht ausgelieferte Arbeit auf diesem Branch – /review, dann /ship." dirty_default → "Nicht committete Änderungen – /review vor dem Committen." clean_default → "Wähle eines: /spec, /investigate oder /qa." Dann das gesehene Token für TASK_TOKEN einsetzen und ausführen (best-effort), und als aktiviert markieren:

~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type first_task_scaffold_shown --skill "TASK_TOKEN" --outcome shown 2>/dev/null || true
touch ~/.gstack/.activated 2>/dev/null || true

Wenn ACTIVATED no ist, aber FIRST_TASK: leer oder nongit ist (headless, nicht-git oder nichts umsetzbar): nichts zeigen, einfach touch ~/.gstack/.activated 2>/dev/null || true ausführen.

Sonst, wenn ACTIVATED yes UND FIRST_LOOP_SHOWN no ist: einmalig als Hinweis sagen (dann fortfahren):

Tipp: gstack zahlt sich aus, wenn du einen kompletten Loop abschließt – planen → überprüfen → ausliefern. Ein typischer erster Loop: /office-hours oder /spec zum Formen, /plan-eng-review zum Festlegen, dann /ship.

Dann touch ~/.gstack/.first-loop-tip-shown 2>/dev/null || true ausführen.

Diesen Abschnitt überspringen, wenn sowohl ACTIVATED als auch FIRST_LOOP_SHOWN yes sind.

Wenn HAS_ROUTING no UND ROUTING_DECLINED false UND PROACTIVE_PROMPTED yes ist: Prüfen, ob eine CLAUDE.md-Datei im Projektstammverzeichnis existiert. Wenn sie nicht existiert, erstelle sie.

AskUserQuestion verwenden:

gstack funktioniert am besten, wenn die CLAUDE.md deines Projekts Skill-Routing-Regeln enthält.

Optionen:

  • A) Routing-Regeln zu CLAUDE.md hinzufügen (empfohlen)
  • B) Nein danke, ich rufe Skills manuell auf

Bei A: Diesen Abschnitt am Ende von CLAUDE.md anhängen:


## Skill routing

Wenn die Anfrage des Benutzers zu einem verfügbaren Skill passt, rufe ihn über das Skill-Tool auf. Im Zweifelsfall den Skill aufrufen.

Wichtige Routing-Regeln:
- Produktideen/Brainstorming → /office-hours aufrufen
- Strategie/Umfang → /plan-ceo-review aufrufen
- Architektur → /plan-eng-review aufrufen
- Designsystem/Plan-Review → /design-consultation oder /plan-design-review aufrufen
- Vollständige Review-Pipeline → /autoplan aufrufen
- Fehler/Fehlermeldungen → /investigate aufrufen
- Automatisierte Tests/CI → /qa aufrufen
- Überprüfung vor dem Ausliefern → /review aufrufen
- Code ausliefern → /ship aufrufen
- Pull Request erstellen → /landing-report aufrufen (dieser Skill)

Standard: Wenn keine der oben genannten Regeln zutrifft, den Skill nicht automatisch aufrufen.

Bei B: ~/.claude/skills/gstack/bin/gstack-config set routing_declined true ausführen

Diesen Abschnitt überspringen, wenn HAS_ROUTING yes oder ROUTING_DECLINED true ist.

Nachdem alle obigen Schritte abgeschlossen sind: Führe das eigentliche Dashboard aus.

Wenn der Benutzer nach dem Dashboard gefragt hat, führe den gstack landing-report-Befehl aus:

~/.claude/skills/gstack/bin/gstack landing-report

Dies zeigt eine Momentaufnahme der aktuellen Versions-Queue, einschließlich:

  • Welche VERSION-Slots von offenen PRs belegt sind
  • Welche Conductor-Workspaces WIP haben
  • Welchen Slot /ship als nächstes auswählen würde

Wenn der Benutzer nicht explizit nach dem Dashboard gefragt hat, sondern nur das Routing durchlaufen hat (z. B. weil der Skill proaktiv aufgerufen wurde), beende den Skill, ohne das Dashboard auszuführen.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills