Communitygithub.com

Générateur de PRD pour Ralph TUI

Génère un document de spécification de produit (PRD) optimisé pour l'orchestration de tâches via ralph-tui. Crée des PRD avec des user stories convertibles en issues beads ou en fichier prd.json pour exécution automatique.

Qu'est-ce que Générateur de PRD pour Ralph TUI ?

Ce skill permet de générer des Product Requirements Documents (PRD) structurés et optimisés pour être exécutés par des agents d'IA via l'outil d'orchestration ralph-tui. Il guide l'utilisateur à travers un processus itératif de questions de clarification (avec options à lettres) pour cerner le problème, la fonctionnalité, le périmètre, les critères de succès et surtout les quality gates (commandes de validation) spécifiques au projet. Le PRD final, délimité par les marqueurs `[PRD]...[/PRD]`, inclut des sections clés comme des user stories atomiques, des exigences fonctionnelles numérotées, des non-objectifs et des métriques de succès. Ce format est conçu pour être parsé par ralph-tui et converti en tâches exécutables (beads issues ou fichier prd.json), garantissant que chaque user story soit petite et vérifiable automatiquement.

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

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 Générateur de PRD pour Ralph TUI ?

Créez des documents de spécification de produit (PRD) détaillés, optimisés pour l'exécution par des agents d'IA via ralph-tui.


Le travail

  1. Recevoir une description de fonctionnalité de la part de l'utilisateur
  2. Poser 3 à 5 questions de clarification essentielles (avec options à lettres) – un ensemble à la fois
  3. Toujours demander quels sont les quality gates (quelles commandes doivent réussir)
  4. Après chaque réponse, poser des questions de suivi si nécessaire (exploration adaptative)
  5. Générer un PRD structuré lorsque le contexte est suffisant
  6. Produire le PRD entouré des marqueurs [PRD]...[/PRD] pour le parsing par la TUI

Important : Ne commencez pas à implémenter. Contentez-vous de créer le PRD.


Étape 1 : Questions de clarification (itératif)

Posez les questions un ensemble à la fois. Chaque réponse doit nourrir les questions suivantes. Concentrez-vous sur :

  • Problème / Objectif : Quel problème cela résout-il ?
  • Fonctionnalité principale : Quelles sont les actions clés ?
  • Périmètre / Limites : Qu'est-ce que cela ne doit PAS faire ?
  • Critères de succès : Comment savoir si c'est terminé ?
  • Intégration : Comment cela s'intègre-t-il avec les fonctionnalités existantes ?
  • Quality Gates : Quelles commandes doivent réussir pour chaque user story ? (OBLIGATOIRE)

Formatez les questions comme ceci :

1. Quel est l'objectif principal de cette fonctionnalité ?
   A. Améliorer l'expérience d'intégration des nouveaux utilisateurs
   B. Augmenter la rétention des utilisateurs
   C. Réduire la charge du support
   D. Autre : [précisez]

2. Qui est l'utilisateur cible ?
   A. Nouveaux utilisateurs uniquement
   B. Utilisateurs existants uniquement
   C. Tous les utilisateurs
   D. Administrateurs uniquement

Cela permet aux utilisateurs de répondre par « 1A, 2C » pour une itération rapide.

Question sur les quality gates (OBLIGATOIRE)

Demandez toujours quels sont les quality gates – ils sont spécifiques au projet :

Quelles commandes de qualité doivent réussir pour chaque user story ?
   A. pnpm typecheck && pnpm lint
   B. npm run typecheck && npm run lint
   C. bun run typecheck && bun run lint
   D. Autre : [précisez vos commandes]

Pour les histoires UI, devons-nous inclure une vérification dans le navigateur ?
   A. Oui, utiliser le skill dev-browser pour vérifier visuellement
   B. Non, les tests automatisés suffisent

Questionnement adaptatif

Après chaque réponse, décidez si vous devez :

  • Poser des questions de suivi (si les réponses révèlent une complexité)
  • Aborder un nouvel aspect (si le domaine actuel est clair)
  • Générer le PRD (si le contexte est suffisant)

Généralement, 2 à 4 séries de questions sont nécessaires.


Étape 2 : Structure du PRD

Générez le PRD avec les sections suivantes :

1. Introduction / Présentation générale

Brève description de la fonctionnalité et du problème qu'elle résout.

2. Objectifs

Objectifs spécifiques et mesurables (liste à puces).

3. Quality Gates

CRITIQUE : Listez les commandes qui doivent réussir pour chaque user story.

## Quality Gates

Ces commandes doivent réussir pour chaque user story :
- `pnpm typecheck` - Vérification des types
- `pnpm lint` - Analyse statique du code

Pour les histoires UI, incluez également :
- Vérifier dans le navigateur à l'aide du skill dev-browser

Cette section est extraite par les outils de conversion (ralph-tui-create-json, ralph-tui-create-beads) et ajoutée aux critères d'acceptation de chaque histoire.

4. User Stories

Chaque histoire doit comporter :

  • Titre : Nom court et descriptif
  • Description : « En tant que [utilisateur], je veux [fonctionnalité] afin de [bénéfice] »
  • Critères d'acceptation : Liste vérifiable de ce que signifie « terminé »

Chaque histoire doit être suffisamment petite pour être implémentée en une session ciblée d'agent d'IA.

Format :

### US-001: [Titre]
**Description :** En tant que [utilisateur], je veux [fonctionnalité] afin de [bénéfice].

**Critères d'acceptation :**
- [ ] Critère vérifiable spécifique
- [ ] Un autre critère

Remarque : N'incluez PAS les commandes de quality gates dans les critères individuels des histoires – elles sont définies une fois dans la section Quality Gates et appliquées automatiquement lors de la conversion.

Important :

  • Les critères d'acceptation doivent être vérifiables, pas vagues
  • « Fonctionne correctement » est mauvais
  • « Un bouton affiche une boîte de confirmation avant de supprimer » est bon
  • Chaque histoire doit être réalisable de manière indépendante

5. Exigences fonctionnelles

Liste numérotée des fonctionnalités spécifiques :

  • « EF-1 : Le système doit permettre aux utilisateurs de... »
  • « EF-2 : Lorsqu'un utilisateur clique sur X, le système doit... »

Soyez explicite et sans ambiguïté.

6. Non-objectifs (Hors périmètre)

Ce que cette fonctionnalité n'inclura PAS. Essentiel pour gérer le périmètre.

7. Considérations techniques (Optionnel)

  • Contraintes ou dépendances connues
  • Points d'intégration avec les systèmes existants
  • Exigences de performance

8. Métriques de succès

Comment le succès sera-t-il mesuré ?

9. Questions ouvertes

Questions restantes ou domaines nécessitant des éclaircissements.


Rédaction pour les agents d'IA

Le PRD sera exécuté par des agents d'IA codeurs via ralph-tui. Par conséquent :

  • Soyez explicite et sans ambiguïté
  • Les user stories doivent être petites (réalisables en une session)
  • Les critères d'acceptation doivent être vérifiables par machine autant que possible
  • Incluez les chemins de fichiers spécifiques si vous les connaissez
  • Référencez les modèles de code existants dans le projet

Format de sortie

CRITIQUE : Entourez le PRD final de marqueurs pour le parsing par la TUI :

[PRD]
# PRD: Nom de la fonctionnalité

## Présentation générale
...

## Quality Gates
...

## User Stories
...
[/PRD]

Nommage du fichier : La TUI enregistrera dans ./tasks/prd-[nom-de-la-fonctionnalité].md


Exemple de déroulement de conversation

Utilisateur : Crée un PRD pour ajouter un mode sombre à la TUI

Assistant : Je vais vous aider à créer un PRD pour le mode sombre. Laissez-moi vous poser quelques questions :

  1. Quel est l'objectif principal ? A. Réduire la fatigue oculaire lors des longues sessions B. Correspondre à la préférence de thème du système C. Offrir une personnalisation visuelle D. Autre

  2. Le réglage doit-il être persistant ? A. Oui, enregistrer dans le fichier de configuration B. Non, session uniquement C. Suivre la préférence du système

Utilisateur : 1A, 2A

Assistant : Parfait ! Encore quelques questions :

  1. Quels composants doivent prendre en charge le mode sombre ? A. Tous les composants de la TUI B. Uniquement la vue d'exécution principale C. Vue principale + paramètres D. Autre

  2. Quelles commandes de qualité doivent réussir pour chaque histoire ? A. pnpm typecheck && pnpm lint B. npm run typecheck && npm run lint C. bun run typecheck D. Autre : [précisez]

  3. Pour les histoires UI, faut-il inclure une vérification dans le navigateur ? A. Oui, utiliser le skill dev-browser B. Non, les tests automatisés suffisent

Utilisateur : 3A, 4A, 5A

Assistant : Parfait, j'ai assez de contexte pour générer le PRD.

[PRD]

PRD: Mode sombre pour Ralph TUI

Présentation générale

Ajouter la prise en charge du mode sombre à ralph-tui afin de réduire la fatigue oculaire pendant les longues sessions d'orchestration. La fonctionnalité s'appliquera à tous les composants de la TUI et enregistrera la préférence de l'utilisateur dans le fichier de configuration.

Objectifs

  • Offrir une expérience de visualisation confortable dans les environnements peu éclairés
  • Conserver la préférence de thème entre les sessions
  • Appliquer un style cohérent à tous les composants de la TUI

Quality Gates

Ces commandes doivent réussir pour chaque user story :

  • pnpm typecheck - Vérification des types
  • pnpm lint - Analyse statique du code

Pour les histoires UI, incluez également :

  • Vérifier dans le navigateur à l'aide du skill dev-browser

User Stories

US-001: Ajout de la configuration du thème

Description : En tant qu'utilisateur, je veux définir mon thème préféré (clair/sombre) afin qu'il persiste entre les sessions.

Critères d'acceptation :

  • Ajouter le champ theme au schéma de .ralph-tui.yaml
  • Prendre en charge les valeurs : « light », « dark », « system »
  • Valeur par défaut « light » pour la rétrocompatibilité

US-002: Création de la palette de couleurs du thème sombre

Description : En tant qu'utilisateur, je veux un thème sombre à faible contraste, agréable pour les yeux.

Critères d'acceptation :

  • Définir une palette sombre avec des tons gris (pas de noir pur)
  • Garantir des rapports de contraste suffisants (WCAG AA)
  • Les couleurs fonctionnent bien pour tous les états de l'interface (sélectionné, survol, désactivé)

US-003: Application du thème aux composants de la TUI

Description : En tant qu'utilisateur, je veux que tous les composants de la TUI respectent ma préférence de thème.

Critères d'acceptation :

  • Le composant d'en-tête utilise les couleurs du thème
  • La liste des tâches utilise les couleurs du thème
  • Les panneaux de détail utilisent les couleurs du thème
  • La barre de progression utilise les couleurs du thème
  • Les boîtes de dialogue utilisent les couleurs du thème

US-004: Ajout du basculement de thème dans les paramètres

Description : En tant qu'utilisateur, je veux pouvoir basculer entre les thèmes depuis les paramètres de la TUI.

Critères d'acceptation :

  • L'option de thème est visible dans la vue des paramètres
  • Les changements s'appliquent immédiatement sans redémarrage
  • Les changements persistent dans le fichier de configuration

Exigences fonctionnelles

  • EF-1 : Le réglage du thème doit pouvoir être lu depuis .ralph-tui.yaml
  • EF-2 : Le thème doit s'appliquer au démarrage de la TUI
  • EF-3 : Les changements de thème dans les paramètres doivent s'appliquer immédiatement
  • EF-4 : Tout le texte doit rester lisible dans les deux thèmes

Non-objectifs

  • Détection automatique du thème système (amélioration future)
  • Schémas de couleurs personnalisés au-delà de clair/sombre
  • Surcharges de thème par composant

Considérations techniques

  • Utiliser les capacités de thématisation existantes d'OpenTUI si disponibles
  • Envisager la création d'un ThemeContext pour les composants React
  • Minimiser les rendus superflus lors du changement de thème

Métriques de succès

  • Tous les composants s'affichent correctement en mode sombre
  • Aucun problème de contraste d'accessibilité
  • Le thème persiste entre les sessions

Questions ouvertes

  • Devrions-nous détecter automatiquement la préférence de thème du système dans une v2 ? [/PRD]

Liste de vérification

Avant de produire le PRD :

  • Questions de clarification posées avec options à lettres
  • Question posée sur les quality gates (OBLIGATOIRE)
  • Questions de suivi posées si nécessaire
  • Section Quality Gates incluse avec les commandes spécifiques au projet
  • Les user stories sont petites et réalisables indépendamment
  • Les user stories n'incluent PAS les commandes de quality gates (elles sont dans la section Quality Gates)
  • Les exigences fonctionnelles sont numérotées et sans ambiguïté
  • La section Non-objectifs définit des limites claires
  • Le PRD est entouré des marqueurs [PRD]...[/PRD]

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