Communitygithub.com

BV - Beads Viewer

Un moteur de triage basé sur des graphes pour les projets Beads. Calcule PageRank, l'intermédiarité, le chemin critique et les cycles. Utilisez les options --robot-* pour les agents IA.

Qu'est-ce que BV - Beads Viewer ?

BV (Beads Viewer) est un outil de triage orienté graphe conçu spécifiquement pour les projets utilisant le format Beads (`.beads/beads.jsonl`). Il calcule automatiquement 9 métriques de graphe (dont PageRank, intermédiarité, HITS, chemin critique et cycles) pour fournir des recommandations exploitables et déterministes. BV se distingue de l'analyse brute des fichiers beads.jsonl en offrant une vue structurée et synthétique de l'état d'avancement du projet, réduisant ainsi le coût cognitif et le volume de données à traiter par un agent IA. Il prend en charge à la fois une interface TUI interactive pour les humains et un mode robot (flags `--robot-*`) pour les agents. Le mode robot expose plusieurs commandes : `--robot-triage` pour une analyse complète avec recommandations, `--robot-next` pour la tâche suivante la plus prioritaire, `--robot-plan` pour les pistes de travail parallèles, et `--robot-insights` pour les métriques de graphe complètes. Une phase de calcul asynchrone avec timeout garantit des résultats rapides : les métriques de première phase (degré, tri topologique, densité) sont instantanées, tandis que les métriques plus lourdes (PageRank, intermédiarité, cycles) ont un timeout de 500ms. Des filtres intégrés (par label, `--recipe`, `--as-of` pour le voyage temporel) permettent de cibler l'analyse. Les sorties JSON des commandes robot incluent toujours un champ `status` pour vérifier la validité des métriques. BV s'intègre naturellement avec la CLI `bd` et peut utiliser les IDs des beads comme identifiants de fils de discussion pour la coordination via les e-mails agents.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/marketplace/bv

Demander à votre IA préférée

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

Documentation

Que fait BV - Beads Viewer ?

Un moteur de triage orienté graphe pour les projets Beads (.beads/beads.jsonl). Calcule 9 métriques de graphe, génère des plans d'exécution et fournit des recommandations déterministes. Interface TUI humaine pour la navigation ; flags robot pour les agents IA.

Pourquoi BV vs Beads bruts

Capacitébeads.jsonl brutMode Robot BV
Requête"Lister tous les problèmes""Lister les 5 principaux goulots d'étranglement bloquant la version"
Coût contextuelÉlevé (linéaire avec le nombre de problèmes)Faible (structure résumée fixe)
Logique de grapheL'agent doit calculerPré-calculé (PageRank, intermédiarité, cycles)
SécuritéL'agent pourrait oublier les cyclesCycles explicitement signalés

Utilisez BV au lieu d'analyser directement les beads.jsonl. Il calcule les métriques de graphe de manière déterministe.

CRITIQUE : Mode Robot pour les Agents

N'exécutez jamais bv nu. Il lance une interface TUI interactive qui bloque votre session.

Utilisez toujours les flags --robot-* :

bv --robot-triage        # LA MÉGA-COMMANDE : commencez ici
bv --robot-next          # Minimal : juste le meilleur choix unique
bv --robot-plan          # Pistes d'exécution parallèles
bv --robot-insights      # Métriques de graphe complètes

Les 9 Métriques de Graphe

BV calcule ces métriques pour révéler les dynamiques cachées du projet :

MétriqueCe qu'elle mesureInformation clé
PageRankImportance récursive des dépendancesBloqueurs fondamentaux
IntermédiaritéTrafic sur le chemin le plus courtGoulots d'étranglement et ponts
HITSDualité Hub/AutoritéEpics vs utilitaires
Chemin critiqueChaîne de dépendance la plus longuePierres angulaires sans marge
Vecteur propreInfluence via les voisinsDépendances stratégiques
DegréNombre de connexions directesBloqueurs/bloqués immédiats
DensitéRapport arêtes/sommetsSanté du couplage du projet
CyclesDépendances circulairesErreurs structurelles (à corriger !)
Tri topologiqueOrdre d'exécution valideBase de la file de travail

Analyse en Deux Phases

BV utilise un calcul asynchrone avec timeout :

  • Phase 1 (instantanée) : degré, tri topologique, densité
  • Phase 2 (timeout de 500 ms) : PageRank, intermédiarité, HITS, vecteur propre, cycles

Vérifiez toujours le champ status dans la sortie. Pour les grands graphes (>500 nœuds), certaines métriques peuvent être approx ou skipped.

Référence des Commandes Robot

Triage & Planification

bv --robot-triage              # Triage complet : recommandations, gains rapides, bloqueurs à lever
bv --robot-next                # Meilleur choix unique avec commande de réclamation
bv --robot-plan                # Pistes d'exécution parallèles avec listes de déblocage
bv --robot-priority            # Détection de désalignement de priorité

Analyse de Graphe

bv --robot-insights            # Métriques complètes : PageRank, intermédiarité, HITS, cycles, etc.
bv --robot-label-health        # Santé par étiquette : healthy|warning|critical
bv --robot-label-flow          # Matrice de flux de dépendances inter-étiquettes
bv --robot-label-attention     # Étiquettes classées par attention

Historique & Modifications

bv --robot-history             # Corrélations bead-commit
bv --robot-diff --diff-since <ref>  # Changements depuis ref

Autres Commandes

bv --robot-burndown <sprint>   # Burndown du sprint, changements de périmètre
bv --robot-forecast <id|all>   # Prédictions d'ETA
bv --robot-alerts              # Problèmes stagnants, cascades de blocage
bv --robot-suggest             # Hygiène : doublons, dépendances manquantes, casses de cycles
bv --robot-graph               # Export du graphe de dépendances (JSON, DOT, Mermaid)
bv --export-graph <file.html>  # Visualisation HTML interactive autonome

Cadrage & Filtrage

bv --robot-plan --label backend              # Cadrer au sous-graphe de l'étiquette
bv --robot-insights --as-of HEAD~30          # Point historique dans le temps
bv --recipe actionable --robot-plan          # Pré-filtre : prêt à travailler
bv --recipe high-impact --robot-triage       # Pré-filtre : top PageRank
bv --robot-triage --robot-triage-by-track    # Grouper par pistes de travail parallèles
bv --robot-triage --robot-triage-by-label    # Grouper par domaine

Recettes Intégrées

RecetteObjectif
defaultTous les problèmes ouverts triés par priorité
actionablePrêt à travailler (aucun bloqueur)
high-impactScores PageRank les plus élevés
blockedEn attente de dépendances
staleOuvert mais inchangé depuis 30+ jours
triageTrié par score de triage calculé
quick-winsÉléments P2/P3 faciles sans bloqueurs
bottlenecksNœuds à haute intermédiarité

Structure de Sortie Robot

Tout JSON robot inclut :

  • data_hash - Empreinte de beads.jsonl (vérifier la cohérence)
  • status - État par métrique : computed|approx|timeout|skipped
  • as_of / as_of_commit - Présent lors de l'utilisation de --as-of

Sortie --robot-triage

{
  "quick_ref": { "open": 45, "blocked": 12, "top_picks": [...] },
  "recommendations": [
    { "id": "bd-123", "score": 0.85, "reason": "Débloque 5 tâches", "unblock_info": {...} }
  ],
  "quick_wins": [...],
  "blockers_to_clear": [...],
  "project_health": { "distributions": {...}, "graph_metrics": {...} },
  "commands": { "claim": "bd claim bd-123", "view": "bv --bead bd-123" }
}

Sortie --robot-insights

{
  "bottlenecks": [{ "id": "bd-123", "value": 0.45 }],
  "keystones": [{ "id": "bd-456", "value": 12.0 }],
  "influencers": [...],
  "hubs": [...],
  "authorities": [...],
  "cycles": [["bd-A", "bd-B", "bd-A"]],
  "clusterDensity": 0.045,
  "status": { "pagerank": "computed", "betweenness": "computed", ... }
}

Référence Rapide jq

bv --robot-triage | jq '.quick_ref'                        # Résumé en un coup d'œil
bv --robot-triage | jq '.recommendations[0]'               # Meilleure recommandation
bv --robot-plan | jq '.plan.summary.highest_impact'        # Meilleure cible de déblocage
bv --robot-insights | jq '.status'                         # Vérifier l'état des métriques
bv --robot-insights | jq '.cycles'                         # Dépendances circulaires (à corriger !)
bv --robot-label-health | jq '.results.labels[] | select(.health_level == "critical")'

Modèle de Flux de Travail Agent

# 1. Commencer par le triage
TRIAGE=$(bv --robot-triage)
NEXT_TASK=$(echo "$TRIAGE" | jq -r '.recommendations[0].id')

# 2. Vérifier d'abord les cycles (erreurs structurelles)
CYCLES=$(bv --robot-insights | jq '.cycles')
if [ "$CYCLES" != "[]" ]; then
  echo "Corriger d'abord les cycles : $CYCLES"
fi

# 3. Réclamer la tâche
bd claim "$NEXT_TASK"

# 4. Travailler dessus...

# 5. Fermer une fois terminé
bd close "$NEXT_TASK"

Vues TUI (pour les Humains)

Lorsque vous exécutez bv de manière interactive (pas pour les agents) :

ToucheVue
lVue liste (par défaut)
bTableau Kanban
gVue graphe (DAG de dépendances)
EVue arborescente (hiérarchie parent-enfant)
iTableau de bord d'informations (6 panneaux de métriques)
hVue historique (corrélation bead-commit)
aPlan actionnable (pistes parallèles)
fMatrice de flux (dépendances inter-étiquettes)
]Vue attention (classement de priorité des étiquettes)

Intégration avec la CLI bd

BV lit depuis .beads/beads.jsonl créé par la CLI bd :

bd init                    # Initialiser les beads dans le projet
bd create "Titre de la tâche"     # Créer un bead
bd list                    # Lister les beads
bd ready                   # Afficher les beads actionnables
bd claim bd-123            # Réclamer un bead
bd close bd-123            # Fermer un bead

Intégration avec le Courrier Agent

Utilisez les IDs des beads comme identifiants de fil de discussion pour la coordination :

file_reservation_paths(..., reason="bd-123")
send_message(..., thread_id="bd-123", subject="[bd-123] Démarrage...")

Formats d'Export de Graphe

bv --robot-graph                              # JSON (par défaut)
bv --robot-graph --graph-format=dot           # Graphviz DOT
bv --robot-graph --graph-format=mermaid       # Diagramme Mermaid
bv --robot-graph --graph-root=bd-123 --graph-depth=3  # Sous-graphe
bv --export-graph report.html                 # HTML interactif

Voyage Temporel

Comparez avec des états historiques :

bv --as-of HEAD~10                    # Il y a 10 commits
bv --as-of v1.0.0                     # À un tag
bv --as-of "2024-01-15"               # À une date
bv --robot-diff --diff-since HEAD~30  # Changements dans les 30 derniers commits

Pièges Courants

ProblèmeCorrection
TUI bloque l'agentUtilisez uniquement les flags --robot-*
Métriques obsolètesVérifiez le champ status, résultats mis en cache par data_hash
Cycles manquantsExécutez --robot-insights, vérifiez .cycles
Mauvaises recommandationsUtilisez --recipe actionable pour filtrer le travail prêt

Notes de Performance

  • Métriques de Phase 1 (degré, topo, densité) : instantanées
  • Métriques de Phase 2 (PageRank, intermédiarité, etc.) : timeout de 500 ms
  • Résultats mis en cache par data_hash
  • Préférez --robot-plan à --robot-insights quand la vitesse compte

Individual skills in this repo

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

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

bg-szy/TOP-SKILLS

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

bg-szy/TOP-SKILLS

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

bg-szy/TOP-SKILLS

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

bg-szy/TOP-SKILLS

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

Skills associés