Communitygithub.com

kelgirechandrakant-cpu/statsarthi

Tableau de bord en lecture seule de la file d'attente des versions, adapté à l'espace de travail (gstack).

Qu'est-ce que statsarthi ?

Cette compétence fournit un tableau de bord en lecture seule de la file d'attente des versions, conçu pour être utilisé avec gstack. Elle est particulièrement utile pour les développeurs et les utilisateurs d'agents IA qui ont besoin de connaître l'état actuel des créneaux de version (version slots), les PR en cours, les espaces de travail Conductor avec du travail en cours prêt à être livré, et le prochain créneau que `/ship` sélectionnera. La compétence prend en charge les plateformes Claude Code, Codex et Cursor, et s'active via la commande `/landing-report` ou des requêtes en langage naturel comme « rapport d'atterrissage », « qu'y a-t-il dans la file d'attente » ou « quel créneau est le prochain ». Elle exécute des vérifications de prérequis, des indicateurs de session, de la télémétrie et de la configuration, puis présente un instantané structuré de la file d'attente de livraison. Elle inclut également des invites de configuration ponctuelles et une détection de projet lors de la première exécution. Cette compétence ne modifie aucun état et est sans danger pour une utilisation en mode planification.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/kelgirechandrakant-cpu/statsarthi/tree/HEAD/.agents/skills/landing-report

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Quand invoquer cette compétence

Affiche quels créneaux de VERSION sont actuellement revendiqués par des PR ouvertes, quels espaces de travail Conductor frères ont du travail en cours (WIP) susceptible d'être livré prochainement, et quel créneau /ship sélectionnera ensuite. Aucune mutation — juste un instantané. À utiliser lorsque l'agent demande un « rapport d'atterrissage », ce qu'il y a dans la file d'attente, « montre-moi les PR ouvertes » ou « quel créneau dois-je revendiquer ensuite ».

/landing-report — Tableau de bord de la file d'attente des versions

Préambule (à exécuter en premier)

_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 "inconnu")
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:-inconnu}
echo "REPO_MODE: $REPO_MODE"
_SESSION_KIND=$(~/.claude/skills/gstack/bin/gstack-session-kind 2>/dev/null || echo "interactif")
case "$_SESSION_KIND" in spawned|headless|interactif) ;; *) _SESSION_KIND="interactif" ;; esac
echo "SESSION_KIND: $_SESSION_KIND"
# Hôte Conductor : AskUserQuestion n'est pas fiable ici (natif désactivé, variante
# MCP instable), donc les compétences rendent les décisions en prose au lieu d'appeler
# l'outil. Conditionné sur !headless pour qu'une exécution eval/CI DANS Conductor (GSTACK_HEADLESS)
# BLOQUE toujours plutôt que de rendre la prose à personne.
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"
# Détection de projet lors de la première exécution : exécuter le détecteur UNIQUEMENT lors de la toute première
# exécution de la compétence (ACTIVATED=no, interactif) afin qu'il reste hors du chemin critique pour chaque exécution ultérieure.
_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"
_UPDATE_CHECK=$(~/.claude/skills/gstack/bin/gstack-config get update_check 2>/dev/null || echo "true")
echo "UPDATE_CHECK: $_UPDATE_CHECK"
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:-inconnu}")'"}'  >> ~/.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 "$HOME/.claude/skills/gstack/bin/gstack-telemetry-log" ]; then
      ~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome inconnu --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:-inconnu}/learnings.jsonl"
if [ -f "$_LEARN_FILE" ]; then
  _LEARN_COUNT=$(wc -l < "$_LEARN_FILE" 2>/dev/null | tr -d ' ')
  echo "LEARNINGS: $_LEARN_COUNT entries chargées"
  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"
for _RF in CLAUDE.md AGENTS.md; do
  if [ -f "$_RF" ] && grep -q "## Skill routing" "$_RF" 2>/dev/null; then
    _HAS_ROUTING="yes"
  fi
done
_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"
# Indice de mode plan pour les compétences comme /spec qui modifient leur comportement
# en fonction de l'état du mode plan. Claude Code expose le mode plan via des rappels
# système ; nous détectons au mieux à partir de CLAUDE_PLAN_FILE (défini par le harnais
# lorsque le mode plan est actif) et revenons à "inactive". Les hôtes Codex et le mode
# d'exécution de Claude se retrouvent tous deux inactifs, ce qui est la valeur par défaut
# sûre (par défaut, pipeline fichier+exécution).
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

Opérations sécurisées en mode plan

En mode plan, autorisées car elles informent le plan : $B, $D, codex exec/codex review, écritures dans ~/.gstack/, écritures dans le fichier plan, et open pour les artefacts générés.

Invocation de compétence en mode plan

Si l'utilisateur invoque une compétence en mode plan, la compétence prévaut sur le comportement générique du mode plan. Traitez le fichier de compétence comme des instructions exécutables, pas comme une référence. Suivez-le étape par étape en commençant par l'étape 0 ; tout AskUserQuestion que la compétence déclenche fait partie du flux de travail en mode plan, pas une violation de celui-ci — et une compétence dont les instructions résolvent elles-mêmes une question (par exemple, une sélection automatique en mode plan) peut légitimement ne pas la poser. AskUserQuestion (toute variante — mcp__*__AskUserQuestion ou native ; voir "Format AskUserQuestion → Résolution d'outil") satisfait à l'exigence de fin de tour du mode plan. Si AskUserQuestion n'est pas disponible ou si un appel échoue, suivez la solution de repli en cas d'échec du format AskUserQuestion : headless → BLOQUÉ ; interactif → le repli en prose (satisfait également à la fin de tour). À un point d'arrêt (STOP), arrêtez-vous immédiatement. Ne continuez pas le flux de travail et n'appelez pas ExitPlanMode à cet endroit. Les commandes marquées "PLAN MODE EXCEPTION — TOUJOURS EXÉCUTÉES" s'exécutent. Appelez ExitPlanMode uniquement après la fin du flux de travail de la compétence, ou si l'utilisateur vous demande d'annuler la compétence ou de quitter le mode plan.

Si PROACTIVE est "false", n'invoquez pas automatiquement et ne suggérez pas de compétences de manière proactive. Si une compétence semble utile, demandez : "Je pense que /nomdelacompétence pourrait vous aider ici — voulez-vous que je l'exécute ?"

Si SKILL_PREFIX est "true", suggérez/invoquez les noms /gstack-*. Les chemins de disque restent ~/.claude/skills/gstack/[nom-de-la-compétence]/SKILL.md.

Si UPDATE_CHECK est "false", sautez les deux lignes suivantes — le binaire de vérification des mises à jour n'émet rien dans ce mode, donc il n'y a pas de sortie UPGRADE_AVAILABLE / JUST_UPGRADED sur laquelle agir.

Si la sortie montre UPGRADE_AVAILABLE <ancien> <nouveau> : lisez ~/.claude/skills/gstack/gstack-upgrade/SKILL.md et suivez le "Flux de mise à niveau en ligne" (mise à niveau automatique si configurée, sinon AskUserQuestion avec 4 options, écrivez l'état de report si refusé).

Si la sortie montre JUST_UPGRADED <de> <vers> : imprimez "Exécution de gstack v{vers} (juste mis à jour !)". Si SPAWNED_SESSION est true, ignorez la découverte de fonctionnalités.

Découverte de fonctionnalités, au maximum une invite par session :

  • Absence de ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint : AskUserQuestion pour les validations automatiques continues (checkpoint). Si accepté, exécutez ~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous. Toujours toucher le marqueur.
  • Absence de ~/.claude/skills/gstack/.feature-prompted-model-overlay : informez "Les superpositions de modèle sont actives. MODEL_OVERLAY affiche le patch." Toujours toucher le marqueur.

Après les invites de mise à niveau, continuez le flux de travail.

Si WRITING_STYLE_PENDING est yes : demandez une fois le style d'écriture :

Les invites v1 sont plus simples : glossaires de jargon pour la première utilisation, questions cadrées par les résultats, prose plus courte. Garder la valeur par défaut ou rétablir le style concis ?

Options :

  • A) Garder la nouvelle valeur par défaut (recommandé — une bonne rédaction aide tout le monde)
  • B) Rétablir la prose V0 — définir explain_level: terse

Si A : laissez explain_level non défini (par défaut à default). Si B : exécutez ~/.claude/skills/gstack/bin/gstack-config set explain_level terse.

Toujours exécuter (quel que soit le choix) :

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

Ignorer si WRITING_STYLE_PENDING est no.

Si LAKE_INTRO est no : dites "gstack suit le principe Boil the Ocean — faites la chose complète lorsque l'IA rend le coût marginal proche de zéro. En savoir plus : https://garryslist.org/posts/boil-the-ocean" Proposez d'ouvrir :

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

N'exécutez open que si oui. Exécutez toujours touch.

Si TEL_PROMPTED est no ET LAKE_INTRO est yes : demandez la télémétrie une fois via AskUserQuestion :

Aidez gstack à s'améliorer. Partagez uniquement les données d'utilisation : compétence, durée, plantages, ID d'appareil stable. Pas de code ni de chemins de fichiers. Le nom de votre dépôt est enregistré localement uniquement et supprimé avant tout téléchargement.

Options :

  • A) Aidez gstack à s'améliorer ! (recommandé)
  • B) Non merci

Si A : exécutez ~/.claude/skills/gstack/bin/gstack-config set telemetry community

Si B : demandez un suivi :

Le mode anonyme n'envoie que des données d'utilisation agrégées, sans identifiant unique.

Options :

  • A) Oui, l'anonyme me va
  • B) Non merci, entièrement désactivé

Si B→A : exécutez ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous Si B→B : exécutez ~/.claude/skills/gstack/bin/gstack-config set telemetry off

Toujours exécuter :

touch ~/.gstack/.telemetry-prompted

Ignorer si TEL_PROMPTED est yes.

Si PROACTIVE_PROMPTED est no ET TEL_PROMPTED est yes : demandez une fois :

Laissez gstack suggérer proactivement des compétences, comme /qa pour "est-ce que ça marche ?" ou /investigate pour les bugs ?

Options :

  • A) Garder activé (recommandé)
  • B) Désactiver — je taperai les /commandes moi-même

Si A : exécutez ~/.claude/skills/gstack/bin/gstack-config set proactive true Si B : exécutez ~/.claude/skills/gstack/bin/gstack-config set proactive false

Toujours exécuter :

touch ~/.gstack/.proactive-prompted

Ignorer si PROACTIVE_PROMPTED est yes.

Guide de première exécution (unique)

Si ACTIVATED est no (première exécution de la compétence sur cette machine) ET le préambule a imprimé une valeur FIRST_TASK: non vide qui n'est PAS nongit : affichez UNE ligne courte et spécifique au projet mappée à partir du jeton, comme information préliminaire, puis CONTINUEZ avec ce que l'utilisateur a réellement demandé — ne bloquez PAS leur tâche. Mappez le jeton : greenfield → "Nouveau dépôt — façonnez-le d'abord avec /spec ou /office-hours." code_node/code_python/code_rust/code_go/code_ruby/code_ios → "Il y a du code ici — /qa pour le voir fonctionner, ou /investigate si quelque chose cloche." branch_ahead → "Travail non livré sur cette branche — /review puis /ship." dirty_default → "Modifications non validées — /review avant de valider." clean_default → "Choisissez-en un : /spec, /investigate, ou /qa." Remplacez ensuite le jeton que vous avez vu par TASK_TOKEN et exécutez (au mieux), et marquez comme activé :

~/.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

Si ACTIVATED est no mais que FIRST_TASK: est vide ou nongit (headless, non git, ou rien d'actionnable) : n'affichez rien, exécutez simplement touch ~/.gstack/.activated 2>/dev/null || true.

Sinon, si ACTIVATED est yes ET FIRST_LOOP_SHOWN est no : dites une fois comme information préliminaire (puis continuez) :

Astuce : gstack est rentable lorsque vous complétez une boucle — planifier → réviser → livrer. Une première boucle courante : /office-hours ou /spec pour la façonner, /plan-eng-review pour la verrouiller, puis /ship.

Exécutez ensuite touch ~/.gstack/.first-loop-tip-shown 2>/dev/null || true.

Ignorez cette section si ACTIVATED et FIRST_LOOP_SHOWN sont tous deux yes.

Si HAS_ROUTING est no ET ROUTING_DECLINED est false ET PROACTIVE_PROMPTED est yes : Vérifiez si un fichier CLAUDE.md existe dans la racine du projet. S'il n'existe pas, créez-le.

Utilisez AskUserQuestion :

gstack fonctionne mieux lorsque le CLAUDE.md de votre projet inclut des règles de routage de compétences.

Options :

  • A) Ajouter des règles de routage à CLAUDE.md (recommandé)
  • B) Non merci, j'invoquerai les compétences manuellement

(suite tronquée pour la traduction)

Si A : exécutez ~/.claude/skills/gstack/bin/gstack-config set routing_declined false Si B : exécutez ~/.claude/skills/gstack/bin/gstack-config set routing_declined true

Toujours exécuter :

~/.claude/skills/gstack/bin/gstack-config set routing_declined false

Utilisation en mode plan

Si GSTACK_PLAN_MODE est active, cette compétence est autorisée en mode plan car elle ne modifie aucun état et fournit uniquement des informations qui éclairent le plan.

Fin du flux de travail

À la fin de l'affichage du tableau de bord, le flux de travail se termine. Ne continuez pas le travail de l'utilisateur à moins qu'il ne le demande explicitement.

Notes techniques

  • Le préambule effectue une série de vérifications de prérequis et de configuration.
  • Les résultats sont rendus sous forme de prose structurée, pas en appelant des outils.
  • La télémétrie est consignée dans ~/.gstack/analytics/skill-usage.jsonl lorsque la télémétrie est activée.
  • Le fichier d'apprentissage est chargé depuis ${GSTACK_HOME:-$HOME/.gstack}/projects/${SLUG:-inconnu}/learnings.jsonl.
  • La session est suivie par ~/.gstack/sessions/ avec une expiration de 120 minutes.

Dépannage

Si le tableau de bord semble vide ou incorrect :

  1. Vérifiez que vous êtes dans un dépôt git avec un historique de version actif.
  2. Vérifiez que les PR sont ouvertes et que gstack est correctement configuré.
  3. Vérifiez que les espaces de travail Conductor sont actifs et visibles.
  4. Exécutez gstack-config list pour inspecter les paramètres de configuration.

Sécurité

Cette compétence ne modifie aucun fichier, branche ou configuration. Elle est en lecture seule et peut être exécutée en toute sécurité dans n'importe quel contexte.


Fin du tableau de bord de la file d'attente des versions.

Individual skills in this repo

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

Skills associés