Communitygithub.com

Landing-Report – Versions-Warteschlangen-Dashboard

Nur-Lese-Dashboard für die versionsbewusste Warteschlange eines Arbeitsbereichs (gstack). Zeigt belegte Versionen, laufende Arbeiten und den nächsten zu reservierenden Slot an.

Was ist Landing-Report – Versions-Warteschlangen-Dashboard?

Diese Skill (Agent-Fähigkeit) ist ein schreibgeschütztes Dashboard für die Versionswarteschlange eines Arbeitsbereichs – es zeigt, welche Versionen derzeit von offenen PRs beansprucht werden, welche Geschwister-Arbeitsbereiche (Conductor Workspaces) kurz vor dem Ausliefern stehen und welchen Slot der Befehl `/ship` als Nächstes wählen würde. Es führt keine Mutationen durch, nur eine Momentaufnahme. Die Skill wird auf Plattformen wie Claude Code, Cursor und ähnlichen KI-Agenten ausgeführt und unterstützt sowohl interaktive als auch headless/CI-Modi. Sie basiert auf einem Preamble-Skript, das Umgebungsvariablen wie BRANCH, SESSION_KIND und PROACTIVE abfragt, Konfigurationen lädt und einmalige Benutzerbefragungen (z. B. zur Telemetrie, Schreibstil und proaktiven Vorschlägen) orchestriert. Nützlich für Entwickler, die schnell einen Überblick über den Auslieferungsstatus ihres Projekts benötigen, ohne den Arbeitsablauf zu unterbrechen.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Wann diese Skill aufgerufen werden sollte

Zeigt an, welche VERSION-Slots aktuell von offenen PRs belegt sind, welche Geschwister-Conductor-Arbeitsbereiche WIP-Arbeiten haben, die wahrscheinlich bald ausgeliefert werden, und welchen Slot /ship als Nächstes wählen würde. Keine Mutationen – nur eine Momentaufnahme. Verwenden, wenn nach „Landing Report“, „Was ist in der Warteschlange?“, „Zeige mir offene PRs“ oder „Welche Version soll ich als Nächstes reservieren?“ gefragt wird.

/landing-report – Versions-Warteschlangen-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 (nativ deaktiviert, MCP-
# Variante instabil), daher geben Skills Entscheidungen als Prosa wieder, anstatt
# das Werkzeug aufzurufen. Auf !headless beschränkt, sodass eine eval/CI-Ausführung
# INNERHALB von Conductor (GSTACK_HEADLESS) weiterhin BLOCKIERT, anstatt Prosa
# an niemanden zu richten.
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: Den Detektor NUR beim ersten Skill-Durchlauf ausführen
# (ACTIVATED=no, interaktiv), damit er für alle folgenden Durchläufe nicht im heißen 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-Zustand
# verzweigen. Claude Code zeigt den Plan-Modus über Systemerinnerungen an; wir erkennen
# ihn bestmöglich aus CLAUDE_PLAN_FILE (vom Harness gesetzt, wenn der Plan-Modus aktiv ist)
# und fallen auf "inactive" zurück. Codex-Hosts und Claude-Ausführungsmodus landen beide
# auf "inactive", dem sicheren Standard (standardmäßig Datei+Ausführungs-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="inactive"
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 informieren: $B, $D, codex exec/codex review, Schreibvorgänge in ~/.gstack/, Schreibvorgänge in die Plan-Datei und open für generierte Artefakte.

Skill-Aufruf während des Plan-Modus

Wenn der Benutzer eine Skill im Plan-Modus aufruft, hat die 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 Eintritt des Workflows in den Plan-Modus, kein Verstoß dagegen. AskUserQuestion (jede Variante – mcp__*__AskUserQuestion oder nativ; siehe „AskUserQuestion-Format → Werkzeugauflösung") erfüllt die End-of-Turn-Anforderung des Plan-Modus. Wenn AskUserQuestion nicht verfügbar ist oder ein Aufruf fehlschlägt, folge dem AskUserQuestion-Format-Fehlerfall: headless → BLOCKIERT; interactive → der Prosa-Fallback (erfüllt ebenfalls End-of-Turn). An einem STOP-Punkt sofort anhalten. Setze den Workflow dort nicht fort und rufe ExitPlanMode nicht auf. Befehle, die mit „PLAN MODE EXCEPTION — ALWAYS RUN"/„PLAN-MODUS-AUSNAHME – IMMER AUSFÜHREN" gekennzeichnet sind, werden ausgeführt. Rufe ExitPlanMode erst auf, nachdem der Skill-Workflow abgeschlossen ist oder der Benutzer dir sagt, die Skill abzubrechen oder den Plan-Modus zu verlassen.

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

Wenn SKILL_PREFIX "true" ist, schlage/rufe Namen /gstack-* vor. Disk-Pfade bleiben ~/.claude/skills/gstack/[skill-name]/SKILL.md.

Wenn die Ausgabe UPGRADE_AVAILABLE <alt> <neu> anzeigt: Lese ~/.claude/skills/gstack/gstack-upgrade/SKILL.md und folge dem „Inline-Upgrade-Ablauf/Inline upgrade flow" (automatisches Upgrade, falls konfiguriert, sonst AskUserQuestion mit 4 Optionen, schreibe Ruhezustand, falls abgelehnt).

Wenn die Ausgabe JUST_UPGRADED <von> <nach> anzeigt: Gib „Führe gstack v{nach} aus (gerade aktualisiert!)" aus. Wenn SPAWNED_SESSION true ist, überspringe die Funktionserkennung.

Funktionserkennung, maximal eine Eingabeaufforderung pro Sitzung:

  • Fehlende ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint: AskUserQuestion für kontinuierliche Checkpoint-Auto-Commits. Wenn akzeptiert, führe ~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous aus. Berühre immer den Marker.
  • Fehlende ~/.claude/skills/gstack/.feature-prompted-model-overlay: Informiere „Modell-Overlays sind aktiv. MODEL_OVERLAY zeigt den Patch." Berühre immer den Marker.

Nach Upgrade-Eingabeaufforderungen setze den Workflow fort.

Wenn WRITING_STYLE_PENDING yes ist: Frage einmal nach dem Schreibstil:

v1-Eingabeaufforderungen sind einfacher: Fachjargon-Erklärungen bei der ersten Verwendung, ergebnisorientierte Fragen, kürzere Prosa. Standard beibehalten oder auf knapp zurücksetzen?

Optionen:

  • A) Neuen Standard behalten (empfohlen – gute Texte helfen allen)
  • B) V0-Prosa wiederherstellen – setze explain_level: terse

Wenn A: explain_level nicht gesetzt lassen (standardmäßig default). Wenn B: Führe ~/.claude/skills/gstack/bin/gstack-config set explain_level terse aus.

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: Sage „gstack folgt dem Boil the Ocean-Prinzip – mache das vollständige Ding, wenn KI die Grenzkosten nahe Null macht. Mehr lesen: https://garryslist.org/posts/boil-the-ocean" Biete an, zu öffnen:

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

Führe open nur aus, wenn ja. Führe touch immer aus.

Wenn TEL_PROMPTED no ist UND LAKE_INTRO yes ist: Frage einmal nach Telemetrie via 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 Upload entfernt.

Optionen:

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

Wenn A: Führe ~/.claude/skills/gstack/bin/gstack-config set telemetry community aus

Wenn B: Frage nach:

Anonymer Modus sendet nur aggregierte Nutzung, keine eindeutige ID.

Optionen:

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

Wenn B→A: Führe ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous aus Wenn B→B: Führe ~/.claude/skills/gstack/bin/gstack-config set telemetry off aus

Immer ausführen:

touch ~/.gstack/.telemetry-prompted

Überspringen, wenn TEL_PROMPTED yes ist.

Wenn PROACTIVE_PROMPTED no ist UND TEL_PROMPTED yes ist: Frage einmal:

Soll gstack proaktiv Skills vorschlagen, wie /qa für „Funktioniert das?" oder /investigate für Fehler?

Optionen:

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

Wenn A: Führe ~/.claude/skills/gstack/bin/gstack-config set proactive true aus Wenn B: Führe ~/.claude/skills/gstack/bin/gstack-config set proactive false aus

Immer ausführen:

touch ~/.gstack/.proactive-prompted

Überspringen, wenn PROACTIVE_PROMPTED yes ist.

Erste-Schritt-Anleitung (einmalig)

Wenn ACTIVATED no ist (erster Skill-Durchlauf auf diesem Rechner) UND die Präambel einen nicht-leeren FIRST_TASK:-Wert ausgegeben hat, der NICHT nongit ist: Zeige EINE kurze, projektspezifische Zeile, die dem Token zugeordnet ist, als Hinweis an, dann FAHRE mit dem fort, was der Benutzer tatsächlich verlangt hat – unterbrich SEINE Aufgabe NICHT. Ordne das Token zu: greenfield → „Frisches Repo – forme es zuerst mit /spec oder /office-hours." 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." Ersetze dann das gesehene Token für TASK_TOKEN und führe aus (best effort) und markiere als aktiviert:

~/.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 Handlungsrelevantes): Zeige nichts, führe nur touch ~/.gstack/.activated 2>/dev/null || true aus.

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

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

Dann führe touch ~/.gstack/.first-loop-tip-shown 2>/dev/null || true aus.

Diesen Abschnitt überspringen, wenn ACTIVATED und FIRST_LOOP_SHOWN beide yes sind.

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

Verwende AskUserQuestion:

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 werde Skills manuell aufrufen

Wenn A: Füge diesen Abschnitt am Ende von CLAUDE.md an:


## Skill routing

Wenn die Anfrage des Benutzers zu einer verfügbaren Skill passt, rufe sie über das Skill-Werkzeug auf. Im Zweifelsfall die Skill aufrufen.

Wichtige Routing-Regeln:
- Produktideen/Brainstorming → Skill /office-hours aufrufen
- Strategie/Umfang → Skill /plan-ceo-review aufrufen
- Architektur → Skill /plan-eng-review aufrufen
- Designsystem/Plan-Review → Skill /design-consultation oder /plan-design-review aufrufen
- Vollständige Review-Pipeline → Skill /autoplan aufrufen
- Fehler/Probleme → Skill /investigate aufrufen
- Qualitätssicherung/Funktionstests → Skill /qa aufrufen
- Plan-Erstellung → Skill /office-hours oder /spec aufrufen
- Code-Review vor dem Ausliefern → Skill /review aufrufen
- Ausliefern/zusammenführen → Skill /ship aufrufen
- Versions-Warteschlangen-Dashboard → Skill /landing-report aufrufen
- Upgrade-Hilfe → Skill /gstack-upgrade aufrufen

Dann: ~/.claude/skills/gstack/bin/gstack-config set routing_declined false ausführen und ~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type routing_rules_applied --skill skill_routing --outcome applied --session-id "$_SESSION_ID" 2>/dev/null || true ausführen.

Wenn B: ~/.claude/skills/gstack/bin/gstack-config set routing_declined true ausführen und ~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type routing_rules_declined --skill skill_routing --outcome declined --session-id "$_SESSION_ID" 2>/dev/null || true ausführen.

Individual skills in this repo

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

Verwandte Skills