Communitygithub.com

charlieviettq/awesome-agent-skill

Tableau de bord en lecture seule des files d'attente de versions, avec connaissance de l'espace de travail (gstack).

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

Cette compétence fournit un tableau de bord en lecture seule de la file d'attente des versions (version queue dashboard) pour les agents IA, leur permettant de voir instantanément quels créneaux de version sont réclamés par des pull requests ouvertes, quels espaces de travail Conductor ont des travaux en cours (WIP) prêts à être livrés, et quel créneau serait choisi par `/ship`. Elle est conçue pour être utilisée avec les plateformes d'agents comme Claude Code, Cursor, Codex ou autres, et repose sur l'outil gstack. Elle ne réalise aucune mutation — c'est une simple capture instantanée (snapshot) qui répond à des requêtes telles que « landing report », « qu'y a-t-il dans la file d'attente ? » ou « quel créneau de version dois-je réclamer ensuite ? ». La compétence inclut un préambule qui collecte des informations sur l'environnement (branche git, mode session, configuration de l'espace de travail Conductor, etc.) avant d'exécuter les opérations du tableau de bord. Elle gère également les invitations à l'utilisation proactive, les mises à jour, la télémétrie, les suggestions de première utilisation, et l'intégration des règles de routage de compétences dans CLAUDE.md. En mode plan, la compétence informe le plan plutôt que de l'exécuter, et elle respecte des règles de sécurité pour les opérations autorisées. Des mécanismes de découverte de fonctionnalités (comme les points de contrôle continus) et des conseils d'écriture sont également intégrés.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/charlieviettq/awesome-agent-skill/tree/HEAD/.cursor/skills/gstack/deploy-ship/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 réclamés par des PR ouvertes, quels espaces de travail Conductor frères ont un travail en cours (WIP) susceptible d'être livré bientôt, et quel créneau /ship sélectionnerait ensuite. Aucune mutation — juste un instantané. Utiliser lorsqu'on vous demande un « landing report », « qu'y a-t-il dans la file d'attente », « montre-moi les PR ouvertes » ou « quel créneau de version dois-je réclamer 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 "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 est peu fiable ici (nat. désactivé, variante MCP
# instable), donc les compétences rendent les décisions en prose au lieu d'appeler
# l'outil. Limité à !headless pour qu'une exécution eval/CI DANS Conductor (GSTACK_HEADLESS)
# reste BLOQUÉE 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 au premier lancement : exécuter le détecteur UNIQUEMENT au premier lancement
# (ACTIVATED=no, interactif) pour qu'il reste hors du chemin chaud pour toutes les exécutions suivantes.
_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 entrées 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"
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"
# Indice en 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
# depuis 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 Claude aboutissent tous deux
# à inactive, 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ûres 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 de 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 a priorité 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 à partir de l'Étape 0 ; la première AskUserQuestion fait entrer le flux de travail en mode plan, ce n'est 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 la solution de secours en cas d'échec du format AskUserQuestion : headless → BLOQUÉ ; interactive → la solution de secours en prose (satisfait également la fin de tour). À un point STOP, arrêtez-vous immédiatement. Ne continuez pas le flux de travail et n'appelez pas ExitPlanMode à ce stade. Les commandes marquées "EXCEPTION MODE PLAN — 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 dit d'annuler la compétence ou de quitter le mode plan.

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

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

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 auto si configurée, sinon AskUserQuestion avec 4 options, écrivez l'état de report si refusé).

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

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

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

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

Si WRITING_STYLE_PENDING est yes : 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. Conserver le défaut ou restaurer le style concis ?

Options :

  • A) Conserver le nouveau défaut (recommandé — une bonne écriture aide tout le monde)
  • B) Restaurer 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

Ignorez 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

Exécutez open uniquement si oui. Toujours exécuter 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 le suivi :

Le mode anonyme envoie uniquement l'utilisation agrégée, sans identifiant unique.

Options :

  • A) D'accord, l'anonyme me convient
  • B) Non merci, complètement 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

Ignorez 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 /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

Ignorez si PROACTIVE_PROMPTED est yes.

Guide de première exécution (unique)

Si ACTIVATED est no (première exécution de compétence sur cette machine) ET le préambule a affiché une valeur FIRST_TASK: non vide qui N'est PAS nongit : montrez 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 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 un : /spec, /investigate, ou /qa. » Ensuite, remplacez 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 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 avertissement (puis continuez) :

Astuce : gstack porte ses fruits lorsque vous terminez une boucle — planifier → réviser → livrer. Une première boucle courante : /office-hours ou /spec pour façonner, /plan-eng-review pour 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

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


## Skill routing

Lorsque la demande de l'utilisateur correspond à une compétence disponible, invoquez-la via l'outil Skill. 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
- Système de conception/révision de plan → invoquer /design-consultation ou /plan-design-review
- Pipeline de révision complet → invoquer /autoplan
- Bugs/erreurs → invoquer

…

[Section tronquée pour la traduction]

Individual skills in this repo

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

Skills associés