Communitygithub.com

charlieviettq/awesome-agent-skill

Tableau de bord en lecture seule de la file d'attente des versions pour le système gstack.

Qu'est-ce que awesome-agent-skill ?

Cette compétence d'agent fournit un tableau de bord en lecture seule de la file d'attente des versions, appelé `/landing-report`, pour le système gstack. Elle affiche les créneaux de version actuellement revendiqués par des pull requests ouvertes, les espaces de travail Conductor avec du travail en cours susceptible d'être livré, et le prochain créneau que `/ship` sélectionnerait. Elle est conçue pour être invoquée lorsque l'utilisateur demande un « rapport d'atterrissage », des informations sur la file d'attente, les PR ouvertes ou la prochaine version à revendiquer. La compétence est utile pour les développeurs utilisant gstack afin de visualiser et de gérer l'état des versions dans un environnement d'équipe, en évitant les conflits de numéros de version. Elle prend en charge les agents Claude Code, Codex et similaires via des fichiers SKILL.md exécutables, et son fonctionnement est défini par une série d'étapes, y compris l'exécution de scripts bash, la gestion des sessions, la télémétrie, et des interactions utilisateur pour les configurations initiales.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/charlieviettq/awesome-agent-skill/tree/HEAD/.claude/skills/gstack-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 VERSION sont actuellement revendiqués par des PR ouvertes, quels espaces de travail Conductor frères ont du travail en cours susceptible d'être livré prochainement, et quel créneau /ship sélectionnerait ensuite. Aucune mutation — juste un instantané. À utiliser lorsqu'on demande un « rapport d'atterrissage », « qu'y a-t-il dans la file d'attente », « affiche les PR ouvertes » ou « quelle version dois-je revendiquer ensuite ».

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

Préambule (exécuter d'abord)

_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 "oui" || echo "non")
_BRANCH=$(git branch --show-current 2>/dev/null || echo "inconnu")
echo "BRANCHE : $_BRANCH"
_SKILL_PREFIX=$(~/.claude/skills/gstack/bin/gstack-config get skill_prefix 2>/dev/null || echo "false")
echo "PROACTIF : $_PROACTIVE"
echo "PROACTIF_SOLICITÉ : $_PROACTIVE_PROMPTED"
echo "PRÉFIXE_COMPÉTENCE : $_SKILL_PREFIX"
source <(~/.claude/skills/gstack/bin/gstack-repo-mode 2>/dev/null) || true
MODE_REPO=${MODE_REPO:-inconnu}
echo "MODE_REPO : $MODE_REPO"
_TYPE_SESSION=$(~/.claude/skills/gstack/bin/gstack-session-kind 2>/dev/null || echo "interactive")
case "$_TYPE_SESSION" in spawné|headless|interactive) ;; *) _TYPE_SESSION="interactive" ;; esac
echo "TYPE_SESSION : $_TYPE_SESSION"
# 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. Bloqué sur !headless afin qu'une exécution CI/évaluation DANS Conductor (GSTACK_HEADLESS)
# BLOQUE plutôt que de rendre la prose à personne.
if [ "$_TYPE_SESSION" != "headless" ] && { [ -n "${CONDUCTOR_WORKSPACE_PATH:-}" ] || [ -n "${CONDUCTOR_PORT:-}" ]; }; then
  echo "SESSION_CONDUCTOR : true"
fi
_ACTIVÉ=$([ -f ~/.gstack/.activated ] && echo "oui" || echo "non")
_PREMIER_TOUR_AFFICHÉ=$([ -f ~/.gstack/.first-loop-tip-shown ] && echo "oui" || echo "non")
echo "ACTIVÉ : $_ACTIVÉ"
echo "PREMIER_TOUR_AFFICHÉ : $_PREMIER_TOUR_AFFICHÉ"
# Détection de projet au premier lancement : exécuter le détecteur UNIQUEMENT au premier lancement de la compétence
# (ACTIVÉ=non, interactive) pour qu'il reste hors du chemin chaud pour toutes les exécutions suivantes.
_PREMIÈRE_TÂCHE=""
if [ "$_ACTIVÉ" = "non" ] && [ "$_TYPE_SESSION" != "headless" ]; then
  _PREMIÈRE_TÂCHE=$(~/.claude/skills/gstack/bin/gstack-first-task-detect 2>/dev/null || true)
fi
echo "PREMIÈRE_TÂCHE : $_PREMIÈRE_TÂCHE"
_LAC_VU=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "oui" || echo "non")
echo "INTRO_LAC : $_LAC_VU"
_TELE=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || true)
_TELE_SOLICITÉ=$([ -f ~/.gstack/.telemetry-prompted ] && echo "oui" || echo "non")
_TELE_DEBUT=$(date +%s)
_ID_SESSION="$$-$(date +%s)"
echo "TÉLÉMÉTRIE : ${_TELE:-désactivée}"
echo "TELE_SOLICITÉ : $_TELE_SOLICITÉ"
_NIVEAU_EXPLICATION=$(~/.claude/skills/gstack/bin/gstack-config get explain_level 2>/dev/null || echo "defaut")
if [ "$_NIVEAU_EXPLICATION" != "defaut" ] && [ "$_NIVEAU_EXPLICATION" != "concis" ]; then _NIVEAU_EXPLICATION="defaut"; fi
echo "NIVEAU_EXPLICATION : $_NIVEAU_EXPLICATION"
_RÉGLAGE_QUESTION=$(~/.claude/skills/gstack/bin/gstack-config get question_tuning 2>/dev/null || echo "false")
echo "RÉGLAGE_QUESTION : $_RÉGLAGE_QUESTION"
mkdir -p ~/.gstack/analytics
if [ "$_TELE" != "désactivée" ]; 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 [ "$_TELE" != "désactivée" ] && [ -x "~/.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 "$_ID_SESSION" 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
_FICHIER_APPRENTISSAGE="${GSTACK_HOME:-$HOME/.gstack}/projects/${SLUG:-inconnu}/learnings.jsonl"
if [ -f "$_FICHIER_APPRENTISSAGE" ]; then
  _NOMBRE_APPRENTISSAGES=$(wc -l < "$_FICHIER_APPRENTISSAGE" 2>/dev/null | tr -d ' ')
  echo "APPRENTISSAGES : $_NOMBRE_APPRENTISSAGES entrées chargées"
  if [ "$_NOMBRE_APPRENTISSAGES" -gt 5 ] 2>/dev/null; then
    ~/.claude/skills/gstack/bin/gstack-learnings-search --limit 3 2>/dev/null || true
  fi
else
  echo "APPRENTISSAGES : 0"
fi
~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"landing-report","event":"started","branch":"'"$_BRANCH"'","session":"'"$_ID_SESSION"'"}' 2>/dev/null &
_A ROUTAGE="non"
if [ -f CLAUDE.md ] && grep -q "## Routage des compétences" CLAUDE.md 2>/dev/null; then
  _A_ROUTAGE="oui"
fi
_ROUTAGE_REFUSÉ=$(~/.claude/skills/gstack/bin/gstack-config get routing_declined 2>/dev/null || echo "false")
echo "A_ROUTAGE : $_A_ROUTAGE"
echo "ROUTAGE_REFUSÉ : $_ROUTAGE_REFUSÉ"
_VENDORISÉ="non"
if [ -d ".claude/skills/gstack" ] && [ ! -L ".claude/skills/gstack" ]; then
  if [ -f ".claude/skills/gstack/VERSION" ] || [ -d ".claude/skills/gstack/.git" ]; then
    _VENDORISÉ="oui"
  fi
fi
echo "GSTACK_VENDORISÉ : $_VENDORISÉ"
echo "SUPERPOSITION_MODÈLE : claude"
_MODE_POINT_VÉRIF=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_mode 2>/dev/null || echo "explicite")
_PROPULSION_POINT_VÉRIF=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_push 2>/dev/null || echo "false")
echo "MODE_POINT_VÉRIF : $_MODE_POINT_VÉRIF"
echo "PROPULSION_POINT_VÉRIF : $_PROPULSION_POINT_VÉRIF"
# 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 à "inactif". Les hôtes Codex et le mode d'exécution 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="actif"
elif [ "${GSTACK_PLAN_MODE:-}" = "actif" ]; then
  export GSTACK_PLAN_MODE="actif"
else
  export GSTACK_PLAN_MODE="inactif"
fi
echo "GSTACK_PLAN_MODE : $GSTACK_PLAN_MODE"
[ -n "$OPENCLAW_SESSION" ] && echo "SESSION_GÉNÉRÉE : 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 pendant le mode plan

Si l'utilisateur invoque une compétence en mode plan, la compétence prime 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 ; la première AskUserQuestion est le flux de travail entrant en mode plan, pas une violation de celui-ci. 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 le repli en cas d'échec du format AskUserQuestion : headless → BLOQUÉ ; interactive → le repli en prose (satisfait également la fin de tour). À un point STOP, arrêtez immédiatement. Ne continuez pas le flux de travail et n'appelez pas ExitPlanMode à cet endroit. Les commandes marquées "EXCEPTION MODE PLAN — TOUJOURS EXÉCUTER" 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 PROACTIF est "false", n'invoquez pas automatiquement et ne suggérez pas proactivement des compétences. Si une compétence semble utile, demandez : « Je pense que /nomcompétence pourrait aider ici — voulez-vous que je l'exécute ? »

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

Si la sortie montre MISE_À_JOUR_DISPONIBLE <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 VIENT_D_ÊTRE_MISÀJOUR <de> <vers> : imprimez « Exécution de gstack v{vers} (vient d'être mis à jour !) ». Si SESSION_GÉNÉRÉE est vrai, ignorez la découverte de fonctionnalités.

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

  • Fichier ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint manquant : AskUserQuestion pour les validations automatiques continues du point de contrôle. Si accepté, exécutez ~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous. Toujours toucher le marqueur.
  • Fichier ~/.claude/skills/gstack/.feature-prompted-model-overlay manquant : informez « Les superpositions de modèle sont actives. MODEL_OVERLAY montre le correctif. » Toujours toucher le marqueur.

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

Si EN_ATTENTE_STYLE_ÉCRITURE est "oui" : demandez une fois à propos du 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 restaurer le style concis ?

Options :

  • A) Garder la nouvelle valeur par défaut (recommandé — une bonne écriture aide tout le monde)
  • B) Restaurer la prose V0 — définir explain_level : concis

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

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

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

Ignorer si EN_ATTENTE_STYLE_ÉCRITURE est "non".

Si INTRO_LAC est "non" : dites « gstack suit le principe Boil the Ocean — faites la chose complète lorsque l'IA rend le coût marginal quasi nul. 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 TELE_SOLICITÉ est "non" ET INTRO_LAC est "oui" : 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 est 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 communauté

Si B : demandez un suivi :

Le mode anonyme envoie uniquement les données d'utilisation agrégées, sans identifiant unique.

Options :

  • A) Oui, l'anonyme me convient
  • B) Non merci, complètement désactivé

Si B→A : exécutez ~/.claude/skills/gstack/bin/gstack-config set telemetry anonyme Si B→B : exécutez ~/.claude/skills/gstack/bin/gstack-config set telemetry désactivée

Toujours exécuter :

touch ~/.gstack/.telemetry-prompted

Ignorer si TELE_SOLICITÉ est "oui".

Si PROACTIF_SOLICITÉ est "non" ET TELE_SOLICITÉ est "oui" : 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 PROACTIF_SOLICITÉ est "oui".

Conseils de première exécution (une fois)

Si ACTIVÉ est "non" (première exécution de la compétence sur cette machine) ET le préambule a imprimé une valeur PREMIÈRE_TÂCHE: non vide qui n'est PAS nongit : affichez UNE ligne courte et spécifique au projet mappée à partir du jeton, comme un avertissement, puis CONTINUEZ avec ce que l'utilisateur a réellement demandé — ne bloquez PAS leur tâche. Mappez le jeton : greenfield → « Dépôt frais — 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 ne va pas. » 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 montré 2>/dev/null || true
touch ~/.gstack/.activated 2>/dev/null || true

Si ACTIVÉ est "non" mais PREMIÈRE_TÂCHE: 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 ACTIVÉ est "oui" ET PREMIER_TOUR_AFFICHÉ est "non" : dites une fois comme avertissement (puis continuez) :

Astuce : gstack rapporte lorsque vous terminez 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.

Ignorer cette section si ACTIVÉ et PREMIER_TOUR_AFFICHÉ sont tous les deux "oui".

Si A_ROUTAGE est "non" ET ROUTAGE_REFUSÉ est "false" ET PROACTIF_SOLICITÉ est "oui" : 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

Si A : Ajoutez cette section à la fin de CLAUDE.md :


## Routage des compétences

Lorsque la demande de l'utilisateur correspond à une compétence disponible, invoquez-la via l'outil Compétence. En cas de doute, invoquez la compétence.

Règles de routage clés :
- Idées de produit/brainstorming → invoquer /office-hours
- Stratégie/portée → invoquer /plan-ceo-review
- Architecture → invoquer /plan-eng-review
- Révision de système de conception/plan → invoquer /design-consultation ou /plan-design-review
- Pipeline de révision complet → invoquer /autoplan
- Bugs/erreurs → invoquer

…

Exécutez ~/.claude/skills/gstack/bin/gstack-config set routing_declined false si A est choisi, ou true si B est choisi.

Individual skills in this repo

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

Skills associés