Communitygithub.com

Ralph TUI PRD 생성기

ralph-tui 작업 오케스트레이션을 위한 제품 요구사항 문서(PRD)를 생성합니다. 사용자 스토리가 포함된 PRD를 생성하여 beads 이슈나 prd.json으로 변환하여 자동 실행할 수 있습니다. 트리거: create a prd, write prd for, plan this feature, requirements for, spec out.

Ralph TUI PRD 생성기란 무엇인가요?

이 스킬은 ralph-tui 기반 AI 에이전트 워크플로우에 최적화된 상세 제품 요구사항 문서(PRD)를 생성하도록 설계되었습니다. 이 스킬의 핵심 가치는 정교한 대화형 프로세스를 통해 사용자가 흩어진 요구사항을 구조화된 기계 판독 가능한 문서로 변환할 수 있게 돕는 데 있습니다. 스킬은 먼저 사용자에게드 선택형 옵션으로 3~5개의 필수 명확화 질문을 던지며, 특히 각 사용자 스토리가 통과해야 하는 품질 게이트(명령어)에 대해 반드시 물어보도록 요구됩니다. 그런 다음 '적응형 탐색'을 통해 답변에 따라 후속 질문을 하여 맥락을 깊이 파고듭니다. 최종 PRD는 `[PRD]...[/PRD]` 마커로 감싸져 ralph-tui가 파싱하고 `{작업 디렉토리}/tasks/prd-[기능명].md` 파일로 저장합니다. 또한 생성된 PRD는 ralph-tui-create-json 및 ralph-tui-create-beads와 같은 도구를 통해 자동 실행 가능한 작업 단위로 변환될 수 있습니다. AI 에이전트에 의한 원활한 실행을 위해 사용자 스토리는 작고 독립적으로 완료 가능하며, 인수 기준은 기계 검증 가능해야 합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Ralph TUI PRD 생성기은(는) 무엇을 하나요?

ralph-tui를 통해 AI 에이전트가 실행할 수 있도록 최적화된 상세 제품 요구사항 문서를 생성합니다.


작업

  1. 사용자로부터 기능 설명 수신
  2. 3~5가지 필수 명확화 질문(문자 선택 옵션 포함)을 한 세트씩 제시
  3. 항상 품질 게이트에 대해 질문(통과해야 하는 명령어)
  4. 각 답변 후 필요시 후속 질문 수행(적응형 탐색)
  5. 충분한 맥락이 확보되면 구조화된 PRD 생성
  6. TUI 파싱을 위해 PRD를 [PRD]...[/PRD] 마커로 감싸서 출력

중요: 구현을 시작하지 마십시오. PRD만 생성하십시오.


1단계: 명확화 질문(반복적)

한 세트씩 질문하십시오. 각 답변은 다음 질문의 기초가 되어야 합니다. 다음에 집중하십시오:

  • 문제/목표: 이 기능이 해결하는 문제는 무엇인가요?
  • 핵심 기능: 주요 동작은 무엇인가요?
  • 범위/경계: 이 기능이 수행하지 말아야 할 것은 무엇인가요?
  • 성공 기준: 완료되었음을 어떻게 알 수 있나요?
  • 통합: 기존 기능과 어떻게 어울리나요?
  • 품질 게이트: 각 스토리가 통과해야 하는 명령어는 무엇인가요? (필수)

질문 형식:

1. 이 기능의 주요 목표는 무엇인가요?
   A. 신규 사용자 온보딩 환경 개선
   B. 사용자 유지율 증가
   C. 지원 부담 감소
   D. 기타: [구체적으로 명시]

2. 대상 사용자는 누구인가요?
   A. 신규 사용자만
   B. 기존 사용자만
   C. 모든 사용자
   D. 관리자만

이렇게 하면 사용자가 "1A, 2C" 형식으로 빠르게 응답할 수 있습니다.

품질 게이트 질문(필수)

항상 품질 게이트에 대해 질문하십시오. 이는 프로젝트별로 다릅니다:

각 사용자 스토리가 통과해야 하는 품질 명령어는 무엇인가요?
   A. pnpm typecheck && pnpm lint
   B. npm run typecheck && npm run lint
   C. bun run typecheck && bun run lint
   D. 기타: [명령어를 지정]

UI 스토리의 경우 브라우저 확인을 포함해야 하나요?
   A. 예, dev-browser 스킬을 사용하여 시각적으로 확인
   B. 아니요, 자동화된 테스트로 충분합니다.

적응형 질문

각 응답 후 다음을 결정하십시오:

  • 후속 질문 수행(답변이 복잡성을 드러내는 경우)
  • 새로운 측면에 대한 질문(현재 영역이 명확한 경우)
  • PRD 생성(충분한 맥락이 있는 경우)

일반적으로 2~4라운드의 질문이 필요합니다.


2단계: PRD 구조

다음 섹션으로 PRD를 생성하십시오:

1. 소개/개요

기능과 해결하는 문제에 대한 간략한 설명.

2. 목표

구체적이고 측정 가능한 목표(글머리 목록).

3. 품질 게이트

중요: 모든 사용자 스토리가 통과해야 하는 명령어를 나열하십시오.

## 품질 게이트

다음 명령어는 모든 사용자 스토리가 통과해야 합니다:
- `pnpm typecheck` - 타입 체크
- `pnpm lint` - 린팅

UI 스토리의 경우 다음도 포함:
- dev-browser 스킬을 사용하여 브라우저에서 확인

이 섹션은 변환 도구(ralph-tui-create-json, ralph-tui-create-beads)에 의해 추출되어 각 스토리의 인수 기준에 추가됩니다.

4. 사용자 스토리

각 스토리에는 다음이 필요합니다:

  • 제목: 짧고 설명적인 이름
  • 설명: "[사용자]로서, [기능]을 원합니다. 그래서 [혜택]을 얻습니다."
  • 인수 기준: "완료"의 의미를 검증 가능한 체크리스트로 작성

각 스토리는 한 번의 집중된 AI 에이전트 세션에서 구현할 수 있을 정도로 작아야 합니다.

형식:

### US-001: [제목]
**설명:** [사용자]로서, [기능]을 원합니다. 그래서 [혜택]을 얻습니다.

**인수 기준:**
- [ ] 구체적인 검증 가능 기준
- [ ] 또 다른 기준

참고: 개별 스토리 기준에 품질 게이트 명령어를 포함하지 마십시오. 품질 게이트 섹션에 한 번 정의되며 변환 중 자동으로 적용됩니다.

중요:

  • 인수 기준은 검증 가능해야 하며 모호하지 않아야 합니다.
  • "올바르게 작동"은 나쁜 예입니다.
  • "버튼이 삭제 전 확인 대화상자를 표시"는 좋은 예입니다.
  • 각 스토리는 독립적으로 완료 가능해야 합니다.

5. 기능 요구사항

번호가 매겨진 구체적인 기능 목록:

  • "FR-1: 시스템은 사용자가 ...을 할 수 있도록 해야 함"
  • "FR-2: 사용자가 X를 클릭하면 시스템은 ...을 해야 함"

명시적이고 모호하지 않게 작성하십시오.

6. 비목표(범위 외)

이 기능에 포함되지 않을 사항. 범위 관리에 매우 중요합니다.

7. 기술적 고려사항(선택 사항)

  • 알려진 제약 조건 또는 종속성
  • 기존 시스템과의 통합 지점
  • 성능 요구사항

8. 성공 지표

성공은 어떻게 측정되나요?

9. 미해결 질문

남아 있는 질문이나 명확화가 필요한 영역.


AI 에이전트를 위한 작성

PRD는 ralph-tui를 통해 AI 코딩 에이전트에 의해 실행됩니다. 따라서:

  • 명시적이고 모호하지 않게 작성
  • 사용자 스토리는 작게 유지(한 세션에 완료 가능)
  • 인수 기준은 가능한 한 기계 검증 가능해야 함
  • 알고 있는 특정 파일 경로를 포함
  • 프로젝트의 기존 코드 패턴을 참조

출력 형식

중요: TUI 파싱을 위해 최종 PRD를 마커로 감싸십시오:

[PRD]
# PRD: 기능명

## 개요
...

## 품질 게이트
...

## 사용자 스토리
...
[/PRD]

파일 이름: TUI는 ./tasks/prd-[기능명].md에 저장합니다.


예시 대화 흐름

사용자: TUI에 다크 모드를 추가하는 PRD를 작성해주세요.

어시스턴트: 다크 모드에 대한 PRD 작성을 도와드리겠습니다. 몇 가지 질문을 드리겠습니다:

  1. 주요 목표는 무엇인가요? A. 긴 세션 동안 눈의 피로 감소 B. 시스템 테마 설정과 일치 C. 시각적 사용자 정의 제공 D. 기타

  2. 설정이 지속되어야 하나요? A. 예, 설정 파일에 저장 B. 아니요, 세션만 유지 C. 시스템 설정 따르기

사용자: 1A, 2A

어시스턴트: 좋습니다! 몇 가지 더 질문드리겠습니다:

  1. 다크 모드를 지원해야 하는 구성 요소는 무엇인가요? A. 모든 TUI 구성 요소 B. 메인 실행 화면만 C. 메인 화면 + 설정 D. 기타

  2. 각 스토리가 통과해야 하는 품질 명령어는 무엇인가요? A. pnpm typecheck && pnpm lint B. npm run typecheck && npm run lint C. bun run typecheck D. 기타: [명령어 지정]

  3. UI 스토리의 경우 브라우저 확인을 포함해야 하나요? A. 예, dev-browser 스킬 사용 B. 아니요, 자동화된 테스트로 충분합니다.

사용자: 3A, 4A, 5A

어시스턴트: 완벽합니다. PRD를 생성하기에 충분한 정보를 얻었습니다.

[PRD]

PRD: Ralph TUI 다크 모드

개요

긴 오케스트레이션 세션 동안 눈의 피로를 줄이기 위해 ralph-tui에 다크 모드 지원을 추가합니다. 이 기능은 모든 TUI 구성 요소에 적용되며 사용자의 설정을 설정 파일에 저장합니다.

목표

  • 저조도 환경에서 편안한 시청 경험 제공
  • 세션 간 테마 설정 유지
  • 모든 TUI 구성 요소에 일관된 스타일 적용

품질 게이트

다음 명령어는 모든 사용자 스토리가 통과해야 합니다:

  • pnpm typecheck - 타입 체크
  • pnpm lint - 린팅

UI 스토리의 경우 다음도 포함:

  • dev-browser 스킬을 사용하여 브라우저에서 확인

사용자 스토리

US-001: 테마 설정 추가

설명: 사용자로서, 선호하는 테마(라이트/다크)를 설정하여 세션 간 유지되기를 원합니다.

인수 기준:

  • .ralph-tui.yaml 스키마에 theme 필드 추가
  • 지원 값: "light", "dark", "system"
  • 하위 호환성을 위해 기본값은 "light"

US-002: 다크 테마 색상 팔레트 생성

설명: 사용자로서, 눈에 편안한 부드러운 대비의 다크 테마를 원합니다.

인수 기준:

  • 회색 톤(순수 검정 아님)의 다크 팔레트 정의
  • 충분한 대비 비율(WCAG AA) 보장
  • 모든 UI 상태(선택됨, 호버, 비활성화)에서 색상이 잘 작동

US-003: TUI 구성 요소에 테마 적용

설명: 사용자로서, 모든 TUI 구성 요소가 내 테마 설정을 따르기를 원합니다.

인수 기준:

  • 헤더 구성 요소가 테마 색상 사용
  • 작업 목록이 테마 색상 사용
  • 세부 패널이 테마 색상 사용
  • 진행 표시줄이 테마 색상 사용
  • 대화상자가 테마 색상 사용

US-004: 설정에 테마 전환 추가

설명: 사용자로서, TUI 설정 내에서 테마를 전환할 수 있기를 원합니다.

인수 기준:

  • 설정 화면에 테마 옵션 표시
  • 변경 사항이 재시작 없이 즉시 적용
  • 변경 사항이 설정 파일에 저장

기능 요구사항

  • FR-1: 테마 설정은 .ralph-tui.yaml에서 읽을 수 있어야 함
  • FR-2: 테마는 TUI 시작 시 적용되어야 함
  • FR-3: 설정에서 테마 변경은 즉시 적용되어야 함
  • FR-4: 모든 텍스트는 두 테마 모두에서 가독성을 유지해야 함

비목표

  • 시스템 테마 자동 감지(향후 개선 사항)
  • 라이트/다크 외 사용자 정의 색상 구성표
  • 구성 요소별 테마 재정의

기술적 고려사항

  • 가능한 경우 기존 OpenTUI 테마 기능 사용
  • React 구성 요소를 위한 ThemeContext 생성 고려
  • 테마 변경 시 리렌더링 최소화

성공 지표

  • 모든 구성 요소가 다크 모드에서 올바르게 렌더링
  • 접근성 대비 문제 없음
  • 테마가 세션 간 유지

미해결 질문

  • v2에서 시스템 테마 설정을 자동으로 감지해야 할까요? [/PRD]

체크리스트

PRD를 출력하기 전에:

  • 문자 선택 옵션이 있는 명확화 질문 수행
  • 품질 게이트에 대해 질문(필수)
  • 필요 시 후속 질문 수행
  • 프로젝트별 명령어가 포함된 품질 게이트 섹션 포함
  • 사용자 스토리가 작고 독립적으로 완료 가능함
  • 사용자 스토리에 품질 게이트 명령어가 포함되지 않음(품질 게이트 섹션에 있음)
  • 기능 요구사항이 번호가 매겨져 있고 모호하지 않음
  • 비목표 섹션이 명확한 경계를 정의
  • PRD가 [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

관련 스킬