Communitygithub.com

ComeOnOliver/skillshub

Convertit des PRD en 'beads' pour l'exécution autonome via ralph-tui en utilisant beads-rust (CLI br). Crée un epic avec des beads enfants pour chaque user story.

Qu'est-ce que skillshub ?

Cette compétence est conçue pour les développeurs et les agents IA qui utilisent ralph-tui avec beads-rust comme système de suivi de tâches. Elle automatise la conversion d'un document de spécification de produit (PRD) en une structure hiérarchique de 'beads' : un epic représentant la fonctionnalité principale et des beads enfants pour chaque user story. La compétence extrait automatiquement les 'Quality Gates' du PRD, dimensionne chaque histoire pour qu'elle soit réalisable en une seule itération de ralph-tui, et ordonne les stories par dépendances (schéma → backend → UI). Elle utilise la CLI `br` pour créer les beads, ajouter les dépendances avec `br dep add`, et exporter les données avec `br sync --flush-only`. La sortie est directement utilisable par ralph-tui pour une exécution autonome, garantissant que chaque tâche est suffisamment petite et que les dépendances sont correctement gérées pour éviter les problèmes de contexte.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/subsy/ralph-tui-create-beads-rust

Demander à votre IA préférée

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

Documentation

Ralph TUI - Créer des Beads (beads-rust)

Convertit les PRD en beads (epic + tâches enfants) pour une exécution autonome avec ralph-tui en utilisant beads-rust (CLI br).

Remarque : Cette compétence utilise la commande br de beads-rust. Si vous avez installé la version originale de beads (bd), utilisez plutôt la compétence ralph-tui-create-beads.


Le Travail

Prenez un PRD (fichier markdown ou texte) et créez des beads à l'aide des commandes br :

  1. Extraire les Quality Gates de la section "Quality Gates" du PRD
  2. Créer un bead epic pour la fonctionnalité
  3. Créer des beads enfants pour chaque user story (avec les quality gates ajoutées)
  4. Configurer les dépendances entre les beads (schéma → backend → UI)
  5. Produire une sortie prête pour ralph-tui run --tracker beads-rust

Étape 1 : Extraire les Quality Gates

Cherchez la section "Quality Gates" dans le PRD :

## Quality Gates

Ces commandes doivent réussir pour chaque user story :
- `pnpm typecheck` - Vérification de typage
- `pnpm lint` - Analyse statique

Pour les stories UI, incluez également :
- Vérifier dans le navigateur en utilisant la compétence dev-browser

Extrayez :

  • Gates universels : Commandes qui s'appliquent à TOUTES les stories (ex. pnpm typecheck)
  • Gates UI : Commandes qui s'appliquent uniquement aux stories UI (ex. vérification navigateur)

Si aucune section Quality Gates n'existe : Demandez à l'utilisateur quelles commandes doivent réussir, ou utilisez une valeur par défaut raisonnable comme npm run typecheck.


Format de Sortie

Les beads utilisent la commande br create avec la syntaxe HEREDOC pour gérer en toute sécurité les caractères spéciaux :

# Créer un epic (lien vers le PRD source)
br create --type=epic \
  --title="[Nom de la fonctionnalité]" \
  --description="$(cat <<'EOF'
[Description de la fonctionnalité depuis le PRD]
EOF
)" \
  --external-ref="prd:./tasks/feature-name-prd.md"

# Créer un bead enfant (avec quality gates dans les critères d'acceptation)
br create \
  --parent=EPIC_ID \
  --title="[Titre de la story]" \
  --description="$(cat <<'EOF'
[Description de la story avec critères d'acceptation INCLUANT les quality gates]
EOF
)" \
  --priority=[1-4]

CRITIQUE : Utilisez toujours <<'EOF' (avec guillemets simples) pour le délimiteur HEREDOC. Cela empêche l'interprétation par le shell des backticks, $variables et () dans les descriptions.


Taille des Stories : La Règle n°1

Chaque story doit pouvoir être terminée en UNE itération de ralph-tui (~une fenêtre de contexte de l'agent).

ralph-tui crée une nouvelle instance d'agent par itération, sans mémoire des travaux précédents. Si une story est trop grande, l'agent épuise son contexte avant de terminer.

Stories de bonne taille :

  • Ajouter une colonne de base de données + migration
  • Ajouter un composant UI à une page existante
  • Mettre à jour une action serveur avec une nouvelle logique
  • Ajouter un menu déroulant de filtre à une liste

Trop grandes (à diviser) :

  • "Construire le tableau de bord complet" → Diviser en : schéma, requêtes, composants UI, filtres
  • "Ajouter l'authentification" → Diviser en : schéma, middleware, UI de connexion, gestion des sessions
  • "Refactorer l'API" → Diviser en une story par point d'accès ou motif

Règle empirique : Si vous ne pouvez pas décrire le changement en 2-3 phrases, c'est trop grand.


Ordre des Stories : D'abord les Dépendances

Les stories s'exécutent dans l'ordre des dépendances. Les stories antérieures ne doivent pas dépendre de stories ultérieures.

Ordre correct :

  1. Changements de schéma/base de données (migrations)
  2. Actions serveur / logique backend
  3. Composants UI qui utilisent le backend
  4. Vues de tableau de bord/récapitulatives qui agrègent les données

Ordre incorrect :

  1. ❌ Composant UI (dépend du schéma qui n'existe pas encore)
  2. ❌ Changement de schéma

Dépendances avec br dep add

Utilisez la commande br dep add pour spécifier quels beads doivent se terminer en premier :

# Créer d'abord les beads
br create --parent=epic-123 --title="US-001 : Ajouter le schéma" ...
br create --parent=epic-123 --title="US-002 : Créer l'API" ...
br create --parent=epic-123 --title="US-003 : Construire l'UI" ...

# Puis ajouter les dépendances (issue dépend-de bloqueur)
br dep add ralph-tui-002 ralph-tui-001  # US-002 dépend de US-001
br dep add ralph-tui-003 ralph-tui-002  # US-003 dépend de US-002

Syntaxe : br dep add <issue> <dépend-de> — l'issue dépend de (est bloquée par) dépend-de.

ralph-tui va :

  • Afficher les beads bloqués comme "bloqués" jusqu'à ce que les dépendances soient terminées
  • Ne jamais sélectionner un bead pour exécution tant que ses dépendances sont ouvertes
  • Inclure le contexte de dépendance dans l'invite lorsqu'il travaille sur un bead

Ordre correct des dépendances :

  1. Changements de schéma/base de données (aucune dépendance)
  2. Logique backend (dépend du schéma)
  3. Composants UI (dépendent du backend)
  4. Intégration/polissage (dépend de l'UI)

Critères d'Acceptation : Quality Gates + Spécifiques à la Story

La description de chaque bead doit inclure les critères d'acceptation avec :

  1. Critères spécifiques à la story du PRD (ce que cette story accomplit)
  2. Quality gates de la section "Quality Gates" du PRD (ajoutés à la fin)

Bons critères (vérifiables) :

  • "Ajouter la colonne investorType à la table investor avec la valeur par défaut 'cold'"
  • "Le menu déroulant de filtre propose les options : Tous, Cold, Friend"
  • "Cliquer sur le bouton bascule affiche une boîte de dialogue de confirmation"

Mauvais critères (vagues) :

  • ❌ "Fonctionne correctement"
  • ❌ "L'utilisateur peut faire X facilement"
  • ❌ "Bonne UX"
  • ❌ "Gère les cas limites"

Règles de Conversion

  1. Extraire les Quality Gates du PRD d'abord
  2. Chaque user story → un bead
  3. Première story : Aucune dépendance (crée la fondation)
  4. Stories suivantes : Dépendent de leurs prédécesseurs (UI dépend du backend, etc.)
  5. Priorité : Basée sur l'ordre des dépendances, puis l'ordre du document (0=critique, 2=moyen, 4=backlog)
  6. Toutes les stories : status: "open"
  7. Critères d'acceptation : Critères de la story + quality gates ajoutés
  8. Stories UI : Ajoutent également les gates spécifiques à l'UI (vérification navigateur)

Division des Gros PRD

Si un PRD contient de grandes fonctionnalités, divisez-les :

Original :

"Ajouter un volet de prospection des amis avec différents messages"

Divisé en :

  1. US-001 : Ajouter le champ investorType à la base de données
  2. US-002 : Ajouter le bouton bascule de type à la liste des investisseurs
  3. US-003 : Créer la logique de progression de phase spécifique aux amis
  4. US-004 : Créer les modèles de messages pour les amis
  5. US-005 : Câbler la génération de tâches pour les amis
  6. US-006 : Ajouter un filtre par type
  7. US-007 : Mettre à jour le formulaire de nouvel investisseur
  8. US-008 : Mettre à jour les compteurs du tableau de bord

Chacun est un changement ciblé qui peut être complété et vérifié indépendamment.


Exemple

PRD d'entrée :

# PRD : Prospection des amis

Ajouter la possibilité de marquer les investisseurs comme "amis" pour une prospection chaleureuse.

## Quality Gates

Ces commandes doivent réussir pour chaque user story :
- `pnpm typecheck` - Vérification de typage
- `pnpm lint` - Analyse statique

Pour les stories UI, incluez également :
- Vérifier dans le navigateur en utilisant la compétence dev-browser

## User Stories

### US-001 : Ajouter le champ investorType à la table investor
**Description :** En tant que développeur, j'ai besoin de catégoriser les investisseurs comme 'cold' ou 'friend'.

**Critères d'acceptation :**
- [ ] Ajouter la colonne investorType : 'cold' | 'friend' (par défaut 'cold')
- [ ] Générer et exécuter la migration avec succès

### US-002 : Ajouter le bouton bascule de type aux lignes de la liste des investisseurs
**Description :** En tant que Ryan, je veux basculer le type d'investisseur directement depuis la liste.

**Critères d'acceptation :**
- [ ] Chaque ligne a un bouton bascule Cold | Friend
- [ ] Le changement affiche une boîte de dialogue de confirmation
- [ ] Sur confirmation : met à jour le type dans la base de données

### US-003 : Filtrer les investisseurs par type
**Description :** En tant que Ryan, je veux filtrer la liste pour voir uniquement les amis ou les froids.

**Critères d'acceptation :**
- [ ] Menu déroulant de filtre : Tous | Cold | Friend
- [ ] Le filtre persiste dans les paramètres d'URL

Beads de sortie :

# Créer l'epic (lien vers le PRD source)
br create --type=epic \
  --title="Volet de prospection des amis" \
  --description="$(cat <<'EOF'
Prospection chaleureuse pour les retours sur deck
EOF
)" \
  --external-ref="prd:./tasks/friends-outreach-prd.md"

# US-001 : Aucune dépendance (première - crée le schéma)
br create --parent=ralph-tui-abc \
  --title="US-001 : Ajouter le champ investorType à la table investor" \
  --description="$(cat <<'EOF'
En tant que développeur, j'ai besoin de catégoriser les investisseurs comme 'cold' ou 'friend'.

## Critères d'acceptation
- [ ] Ajouter la colonne investorType : 'cold' | 'friend' (par défaut 'cold')
- [ ] Générer et exécuter la migration avec succès
- [ ] pnpm typecheck réussit
- [ ] pnpm lint réussit
EOF
)" \
  --priority=1

# US-002 : Story UI (reçoit également la vérification navigateur)
br create --parent=ralph-tui-abc \
  --title="US-002 : Ajouter le bouton bascule de type aux lignes de la liste" \
  --description="$(cat <<'EOF'
En tant que Ryan, je veux basculer le type d'investisseur directement depuis la liste.

## Critères d'acceptation
- [ ] Chaque ligne a un bouton bascule Cold | Friend
- [ ] Le changement affiche une boîte de dialogue de confirmation
- [ ] Sur confirmation : met à jour le type dans la base de données
- [ ] pnpm typecheck réussit
- [ ] pnpm lint réussit
- [ ] Vérifier dans le navigateur en utilisant la compétence dev-browser
EOF
)" \
  --priority=2

# Ajouter la dépendance : US-002 dépend de US-001
br dep add ralph-tui-002 ralph-tui-001

# US-003 : Story UI
br create --parent=ralph-tui-abc \
  --title="US-003 : Filtrer les investisseurs par type" \
  --description="$(cat <<'EOF'
En tant que Ryan, je veux filtrer la liste pour voir uniquement les amis ou les froids.

## Critères d'acceptation
- [ ] Menu déroulant de filtre : Tous | Cold | Friend
- [ ] Le filtre persiste dans les paramètres d'URL
- [ ] pnpm typecheck réussit
- [ ] pnpm lint réussit
- [ ] Vérifier dans le navigateur en utilisant la compétence dev-browser
EOF
)" \
  --priority=3

# Ajouter la dépendance : US-003 dépend de US-002
br dep add ralph-tui-003 ralph-tui-002

Synchronisation des Changements

Après avoir créé les beads, synchronisez pour exporter au format JSONL (pour le suivi git) :

br sync --flush-only

Ceci exporte la base de données SQLite vers .beads/issues.jsonl pour le contrôle de version.


Emplacement de Sortie

Les beads sont stockés dans le répertoire : .beads/ (base de données SQLite + export JSONL)

Après la création, exécutez ralph-tui :

# Travailler sur un epic spécifique
ralph-tui run --tracker beads-rust --epic ralph-tui-abc

# Ou le laisser choisir automatiquement la meilleure tâche
ralph-tui run --tracker beads-rust

ralph-tui va :

  1. Travailler sur les beads dans l'epic spécifié (ou sélectionner la meilleure tâche disponible)
  2. Fermer chaque bead une fois terminé
  3. Fermer l'epic lorsque tous les enfants sont terminés
  4. Afficher <promise>COMPLETE</promise> lorsque l'epic est terminé

Liste de Vérification Avant de Créer les Beads

  • Quality Gates extraits du PRD (ou demandé à l'utilisateur si manquant)
  • Chaque story peut être terminée en une itération (assez petite)
  • Les stories sont ordonnées par dépendance (schéma → backend → UI)
  • Quality gates ajoutés aux critères d'acceptation de chaque bead
  • Les stories UI ont une vérification navigateur (si spécifié dans les Quality Gates)
  • Les critères d'acceptation sont vérifiables (pas vagues)
  • Aucune story ne dépend d'une story ultérieure (uniquement des stories antérieures)
  • Dépendances ajoutées avec br dep add après la création des beads
  • br sync --flush-only exécuté pour exporter pour le suivi git

Différences avec beads (version Go)

Commandebeads (bd)beads-rust (br)
Créerbd createbr create
Dépendancesbd dep addbr dep add
Synchroniserbd syncbr sync --flush-only
Fermerbd closebr close
Stockage.beads/beads.jsonl.beads/*.db + export JSONL

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

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.

ComeOnOliver/skillshub

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.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills associés