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 continuousausfü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: tersesetzen
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-hoursoder/speczum Formen,/plan-eng-reviewzum 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
/shipals 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.