Communitygithub.com

Francixco90/metodologia-frames-agent-os

Schreibgeschütztes Warteschlangen-Dashboard für workspace-bewusste Auslieferungen (gstack).

Was ist metodologia-frames-agent-os?

Diese Skill bietet ein schreibgeschütztes Dashboard zur Überwachung der Versions-Warteschlange in einem auf gstack basierenden Arbeitsablauf. Sie zeigt an, welche VERSION-Slots derzeit von offenen Pull-Requests beansprucht werden, welche Conductor-Arbeitsbereiche laufende Arbeiten (WIP) enthalten, die bald ausgeliefert werden könnten, und welchen Slot der Befehl `/ship` als Nächstes auswählen würde. Die Skill ist speziell für Claude Code (ehemals Claude Agent) konzipiert und nutzt die systemweite `gstack`-Installation, um Daten zu sammeln. Einmal aufgerufen, führt die Skill eine Reihe von Befehlen aus, um Kontext wie den aktuellen Branch, die Sitzungsart (interaktiv, gespawned, headless) und die Konfiguration (`proactive`, `skill_prefix`, `telemetry` usw.) zu sammeln und diesen dem Agenten als Entscheidungsgrundlage für die Benutzerinteraktion zur Verfügung zu stellen. Die Skill unterstützt Optionen wie die Anzeige von Upgrade-Hinweisen, das erste Mal und die Integration mit Conductor und macht sie zu einem unverzichtbaren Werkzeug für Entwickler, die mit einem CI/CD-Workflow arbeiten.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Francixco90/metodologia-frames-agent-os/tree/HEAD/03_artefactos/skills/vendor/gstack/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 soll

Zeigt an, welche VERSION-Slots aktuell von offenen PRs belegt sind, welche Conductor-Arbeitsbereiche WIP-Arbeiten enthalten, die wahrscheinlich bald ausgeliefert werden, und welchen Slot /ship als Nächstes auswählen würde. Keine Mutationen — nur eine Momentaufnahme. Verwenden Sie diese Skill bei Fragen wie „Landing Report“, „Was ist in der Warteschlange?“, „Zeig mir offene PRs“ oder „Welche Version soll ich als Nächstes beanspruchen?“.

/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 (native deaktiviert, MCP-
# Variante instabil), daher geben Skills Entscheidungen als Prosa aus, anstatt das Tool
# aufzurufen. Abhängig von !headless, damit ein eval/CI-Lauf INNERHALB von Conductor (GSTACK_HEADLESS)
# immer noch BLOCKIERT, anstatt Prosa an niemanden 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"
# Erstmalige Projekterkennung: den Detektor NUR beim allerersten Skill-Lauf ausführen
# (ACTIVATED=no, interaktiv), damit er für jeden weiteren Lauf nicht auf dem 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":"started","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
# bestmöglich anhand von CLAUDE_PLAN_FILE (gesetzt vom Harness, wenn der Plan-Modus
# aktiv ist) und fallen auf "inactive" zurück. Codex-Hosts und Claude-Ausführungsmodus
# landen beide auf inactive, was der sichere Standard ist (standardmäßig Datei+Ausführungspipeline).
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, weil sie den Plan informieren: $B, $D, codex exec/codex review, Schreibzugriff auf ~/.gstack/, Schreibzugriff auf die Plan-Datei und open für generierte Artefakte.

Skill-Aufruf im Plan-Modus

Wenn der Benutzer eine Skill im Plan-Modus aufruft, hat die Skill Vorrang vor dem generischen Plan-Modus-Verhalten. Behandeln Sie die Skill-Datei als ausführbare Anweisungen, nicht als Referenz. Folgen Sie ihr Schritt für Schritt ab Schritt 0; die erste AskUserQuestion ist der Workflow, der in den Plan-Modus eintritt, kein Verstoß dagegen. AskUserQuestion (jede Variante — mcp__*__AskUserQuestion oder nativ; siehe „AskUserQuestion-Format → Tool-Auflösung“) erfüllt die End-of-Turn-Anforderung des Plan-Modus. Wenn AskUserQuestion nicht verfügbar ist oder ein Aufruf fehlschlägt, folgen Sie dem Fehler-Fallback des AskUserQuestion-Formats: headless → BLOCKIERT; interactive → der Prosa-Fallback (erfüllt ebenfalls End-of-Turn). Halten Sie an einem STOP-Punkt sofort an. Setzen Sie den Workflow nicht fort und rufen Sie ExitPlanMode dort nicht auf. Befehle, die mit „PLAN MODE EXCEPTION — ALWAYS RUN“ markiert sind, werden ausgeführt. Rufen Sie ExitPlanMode erst auf, wenn der Skill-Workflow abgeschlossen ist oder wenn der Benutzer Ihnen sagt, dass Sie die Skill abbrechen oder den Plan-Modus verlassen sollen.

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

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

Wenn die Ausgabe UPGRADE_AVAILABLE <old> <new> zeigt: ~/.claude/skills/gstack/gstack-upgrade/SKILL.md lesen und dem „Inline-Upgrade-Flow“ folgen (Autoupgrade, falls konfiguriert, sonst AskUserQuestion mit 4 Optionen, Snooze-Status schreiben, falls abgelehnt).

Wenn die Ausgabe JUST_UPGRADED <from> <to> zeigt: „Running gstack v{to} (just updated!)“ ausgeben. Wenn SPAWNED_SESSION wahr ist, Feature-Discovery überspringen.

Feature-Discovery, maximal eine Eingabeaufforderung pro Sitzung:

  • Fehlende ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint: AskUserQuestion für Continuous Checkpoint Auto-Commits. Wenn akzeptiert, ~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous ausführen. Immer Marker berühren.
  • Fehlende ~/.claude/skills/gstack/.feature-prompted-model-overlay: informieren „Model overlays are active. MODEL_OVERLAY shows the patch.“ Immer Marker berühren.

Nach Upgrade-Eingabeaufforderungen Workflow fortsetzen.

Wenn WRITING_STYLE_PENDING yes ist: einmalig nach Schreibstil fragen:

v1-Eingabeaufforderungen sind einfacher: Glossar zur ersten Verwendung, ergebnisorientierte Fragen, kürzere Prosa. Standard beibehalten oder komprimierte wiederherstellen?

Optionen:

  • A) Neuen Standard beibehalten (empfohlen — gute Schreibweise hilft allen)
  • B) V0-Prosa wiederherstellen — explain_level: terse setzen

Wenn A: explain_level nicht gesetzt lassen (standardmäßig auf default). Wenn 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 — das Komplette tun, wenn KI die Grenzkosten nahe Null bringt. Mehr lesen: 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 IST UND LAKE_INTRO yes ist: einmalig nach Telemetrie über AskUserQuestion fragen:

Helfen Sie gstack, besser zu werden. Teilen Sie nur Nutzungsdaten: Skill, Dauer, Abstürze, stabile Geräte-ID. Kein Code oder Dateipfade. Ihr Repo-Name wird nur lokal aufgezeichnet und vor jedem Upload entfernt.

Optionen:

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

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

Wenn B: Folgefrage stellen:

Anonymer Modus sendet nur aggregierte Nutzung, keine eindeutige ID.

Optionen:

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

Wenn B→A: ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous ausführen Wenn 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 IST UND TEL_PROMPTED yes ist: einmalig fragen:

gstack proaktiv Skills vorschlagen lassen, wie /qa für „funktioniert das?“ oder /investigate für Fehler?

Optionen:

  • A) Anlassen (empfohlen)
  • B) Ausschalten — ich tippe /commands selbst

Wenn A: ~/.claude/skills/gstack/bin/gstack-config set proactive true ausführen Wenn 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.

Erstanleitung (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 anzeigen, die dem Token zugeordnet ist, als Hinweis, dann mit dem FORTFAHREN, was der Benutzer tatsächlich gefragt hat — die Aufgabe NICHT anhalten. Token zuordnen: greenfield → „Frisches Repo — zuerst mit /spec oder /office-hours formen.“ code_node/code_python/code_rust/code_go/code_ruby/code_ios → „Hier gibt es Code — /qa um zu sehen, ob es funktioniert, oder /investigate falls 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ählen Sie: /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 Handhabbares): nichts anzeigen, nur touch ~/.gstack/.activated 2>/dev/null || true ausführen.

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

Tipp: gstack zahlt sich aus, wenn Sie eine Schleife abschließen — planen → überprüfen → ausliefern. Ein typischer erster Durchlauf: /office-hours oder /spec zum Formen, /plan-eng-review zum Verriegeln, 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 IST UND ROUTING_DECLINED false IST UND PROACTIVE_PROMPTED yes ist: Prüfen Sie, ob eine CLAUDE.md-Datei im Projektstammverzeichnis vorhanden ist. Wenn sie nicht vorhanden ist, erstellen Sie sie.

AskUserQuestion verwenden:

gstack funktioniert am besten, wenn Ihr Projekt-CLAUDE.md Skill-Routing-Regeln enthält.

Optionen:

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

Wenn A: Diesen Abschnitt an das Ende von CLAUDE.md anhängen:


## Skill-Routing

Wenn die Anfrage des Benutzers mit einer verfügbaren Skill übereinstimmt, rufen Sie diese über das Skill-Tool auf. Im Zweifelsfall die 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/Probleme → /investigate aufrufen
- Änderungen überprüfen/qualitätssichern → /review oder /qa aufrufen
- Auslieferung/Veröffentlichung → /ship aufrufen


Dann touch ~/.gstack/.activated 2>/dev/null || true ausführen.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills