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 continuousaus. 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-hoursoder/speczum Formen,/plan-eng-reviewzum 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.