Communitygithub.com

Ralph TUI - ビーズ作成

PRDをralph-tui実行用のビーズ(エピック+子タスク)に変換します。PRDがあり、ralph-tuiをビーズタスクソースとして使用したい場合に使用します。

Ralph TUI - ビーズ作成 とは?

このスキルは、PRD(製品要件定義書)をralph-tuiで自律実行可能な「ビーズ」形式に変換するための強力なツールです。主にralph-tuiのBeadsトラッカープラグインと組み合わせて使用します。スキルはまずPRDから「品質ゲート(Quality Gates)」を抽出し、機能全体を表すエピックビーズと、各ユーザーストーリーごとの子ビーズを作成します。各子ビーズには受け入れ基準に品質ゲートが追加され、スキーマ→バックエンド→UIの依存関係順に自動設定されます。大きなストーリーは自動的に分割され、各ビーズがralph-tuiの一度のイテレーションで完了可能なサイズに保たれます。出力は`.beads/beads.jsonl`に書き込まれ、`ralph-tui run --tracker beads`で即座に実行可能です。このスキールは、開発者がPRDから直接、明確な依存関係と検証可能な基準を持つ実行可能なタスクリストを生成できるようにします。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Ralph TUI - ビーズ作成 は何をしますか?

PRDをralph-tui自律実行用のビーズ(エピック+子タスク)に変換します。

注記: このスキルはralph-tuiのBeadsトラッカープラグインにバンドルされています。今後のトラッカープラグイン(Linear、GitHub Issuesなど)には、それぞれ独自のタスク作成スキルがバンドルされる予定です。


ジョブ

PRD(Markdownファイルまたはテキスト)を取得し、.beads/beads.jsonlにビーズを作成します:

  1. PRDの「品質ゲート」セクションから品質ゲートを抽出
  2. 機能のエピックビーズを作成
  3. 各ユーザーストーリーごとに子ビーズを作成(品質ゲートを追加)
  4. ビーズ間の依存関係を設定(スキーマ → バックエンド → UI)
  5. ralph-tui run --tracker beadsで実行可能な状態で出力

ステップ1:品質ゲートの抽出

PRD内の「品質ゲート」セクションを探します:

## 品質ゲート

すべてのユーザーストーリーで合格しなければならないコマンド:
- `pnpm typecheck` - 型チェック
- `pnpm lint` - リンティング

UIストーリーの場合、以下も含めます:
- dev-browserスキルを使用してブラウザで確認

抽出するもの:

  • 共通ゲート: すべてのストーリーに適用されるコマンド(例:pnpm typecheck)
  • UIゲート: UIストーリーのみに適用されるコマンド(例:ブラウザ確認)

品質ゲートセクションがない場合: ユーザーにどのコマンドを合格させるか尋ねるか、npm run typecheckなどの適切なデフォルトを使用します。


出力形式

ビーズはbd createコマンドとヒアドキュメント構文を使用して、特殊文字を安全に処理します:

# エピックを作成(ソースPRDへのリンク)
bd create --type=epic \
  --title="[機能名]" \
  --description="$(cat <<'EOF'
[PRDからの機能説明]
EOF
)" \
  --external-ref="prd:./tasks/feature-name-prd.md"

# 子ビーズを作成(受け入れ基準に品質ゲートを含む)
bd create \
  --parent=EPIC_ID \
  --title="[ストーリータイトル]" \
  --description="$(cat <<'EOF'
[受け入れ基準を含むストーリー説明(品質ゲートも含む)]
EOF
)" \
  --priority=[1-4]

重要: ヒアドキュメントの区切り文字には常に<<'EOF'(シングルクォート)を使用してください。これにより、説明内のバッククォート、$variables、()がシェルによって解釈されるのを防ぎます。


ストーリーサイズ:最も重要なルール

各ストーリーは、ralph-tuiの1回のイテレーション(約1エージェントコンテキストウィンドウ)で完了可能でなければなりません。

ralph-tuiはイテレーションごとに新しいエージェントインスタンスを生成し、以前の作業の記憶はありません。ストーリーが大きすぎると、エージェントはコンテキストが不足して完了できません。

適切なサイズのストーリー:

  • データベースカラムとマイグレーションの追加
  • 既存ページへのUIコンポーネントの追加
  • 新しいロジックによるサーバーアクションの更新
  • リストへのフィルタードロップダウンの追加

大きすぎる(分割が必要):

  • 「ダッシュボード全体を構築」→ スキーマ、クエリ、UIコンポーネント、フィルターに分割
  • 「認証を追加」→ スキーマ、ミドルウェア、ログインUI、セッション処理に分割
  • 「APIをリファクタリング」→ エンドポイントまたはパターンごとに1ストーリーに分割

目安: 変更を2〜3文で説明できない場合、それは大きすぎます。


ストーリーの順序:依存関係を優先

ストーリーは依存関係の順序で実行されます。前のストーリーは後のストーリーに依存してはいけません。

正しい順序:

  1. スキーマ/データベースの変更(マイグレーション)
  2. サーバーアクション / バックエンドロジック
  3. バックエンドを使用するUIコンポーネント
  4. データを集約するダッシュボード/サマリービュー

間違った順序:

  1. ❌ UIコンポーネント(まだ存在しないスキーマに依存)
  2. ❌ スキーマ変更

bd dep addを使用した依存関係

bd dep addコマンドを使用して、最初に完了する必要があるビーズを指定します:

# 最初にビーズを作成
bd create --parent=epic-123 --title="US-001: スキーマ追加" ...
bd create --parent=epic-123 --title="US-002: API作成" ...
bd create --parent=epic-123 --title="US-003: UI構築" ...

# 次に依存関係を追加(issueはdepends-onに依存)
bd dep add ralph-tui-002 ralph-tui-001  # US-002はUS-001に依存
bd dep add ralph-tui-003 ralph-tui-002  # US-003はUS-002に依存

構文: bd dep add <issue> <depends-on> — issueはdepends-onに依存(ブロック)されます。

ralph-tuiは次のことを行います:

  • 依存関係が完了するまでブロックされたビーズを「blocked」と表示
  • 依存関係が開いている間は、ビーズを実行対象として選択しない
  • ビーズに取り組む際に、プロンプトに依存関係のコンテキストを含める

正しい依存関係の順序:

  1. スキーマ/データベースの変更(依存関係なし)
  2. バックエンドロジック(スキーマに依存)
  3. UIコンポーネント(バックエンドに依存)
  4. 統合/ポリッシュ(UIに依存)

受け入れ基準:品質ゲート+ストーリー固有

各ビーズの説明には、次の受け入れ基準を含める必要があります:

  1. PRDからのストーリー固有の基準(このストーリーが達成すること)
  2. PRDの品質ゲートセクションからの品質ゲート(最後に追加)

良い基準(検証可能):

  • 「investorテーブルにデフォルト'cold'のinvestorTypeカラムを追加」
  • 「フィルタードロップダウンにオプション:すべて、コールド、フレンド」
  • 「トグルをクリックすると確認ダイアログが表示される」

悪い基準(曖昧):

  • ❌ 「正しく動作する」
  • ❌ 「ユーザーがXを簡単にできる」
  • ❌ 「良いUX」
  • ❌ 「エッジケースを処理する」

変換ルール

  1. PRDから品質ゲートを抽出する
  2. 各ユーザーストーリー→1つのビーズ
  3. 最初のストーリー: 依存関係なし(基盤を作成)
  4. 後続のストーリー: 先行ストーリーに依存(UIはバックエンドに依存するなど)
  5. 優先度: 依存関係の順序、次にドキュメントの順序に基づく(0=クリティカル、2=中、4=バックログ)
  6. すべてのストーリー: status: "open"
  7. 受け入れ基準: ストーリー基準+品質ゲートを追加
  8. UIストーリー: UI固有のゲートも追加(ブラウザ確認)

大きなPRDの分割

PRDに大きな機能がある場合は、分割します:

元のPRD:

「異なるメッセージングでフレンドアウトリーチトラックを追加」

分割後:

  1. US-001: データベースにinvestorTypeフィールドを追加
  2. US-002: 投資家リストUIにタイプトグルを追加
  3. US-003: フレンド固有のフェーズ進行ロジックを作成
  4. US-004: フレンドメッセージテンプレートを作成
  5. US-005: フレンドのタスク生成を配線
  6. US-006: タイプによるフィルターを追加
  7. US-007: 新規投資家フォームを更新
  8. US-008: ダッシュボードカウントを更新

それぞれが1つの焦点を絞った変更であり、独立して完了および検証できます。


例

入力PRD:

# PRD: フレンドアウトリーチ

投資家を「フレンド」としてマークし、温かいアウトリーチを行う機能を追加。

## 品質ゲート

すべてのユーザーストーリーで合格しなければならないコマンド:
- `pnpm typecheck` - 型チェック
- `pnpm lint` - リンティング

UIストーリーの場合、以下も含めます:
- dev-browserスキルを使用してブラウザで確認

## ユーザーストーリー

### US-001: investorテーブルにinvestorTypeフィールドを追加
**説明:** 開発者として、投資家を'cold'または'friend'に分類する必要があります。

**受け入れ基準:**
- [ ] investorTypeカラムを追加:'cold' | 'friend'(デフォルト'cold')
- [ ] マイグレーションを生成して実行

### US-002: 投資家リスト行にタイプトグルを追加
**説明:** Ryanとして、リストから直接投資家タイプを切り替えたい。

**受け入れ基準:**
- [ ] 各行にCold | Friendトグルがある
- [ ] 切り替えると確認ダイアログが表示される
- [ ] 確認時:データベースのタイプを更新

### US-003: 投資家をタイプでフィルター
**説明:** Ryanとして、フレンドまたはコールドだけを表示するようにリストをフィルターしたい。

**受け入れ基準:**
- [ ] フィルタードロップダウン:すべて | コールド | フレンド
- [ ] フィルターはURLパラメータに保持される

出力ビーズ:

# エピックを作成(ソースPRDへのリンク)
bd create --type=epic \
  --title="フレンドアウトリーチトラック" \
  --description="$(cat <<'EOF'
デッキフィードバックのための温かいアウトリーチ
EOF
)" \
  --external-ref="prd:./tasks/friends-outreach-prd.md"

# US-001: 依存関係なし(最初 - スキーマを作成)
bd create --parent=ralph-tui-abc \
  --title="US-001: investorテーブルにinvestorTypeフィールドを追加" \
  --description="$(cat <<'EOF'
開発者として、投資家を'cold'または'friend'に分類する必要があります。

## 受け入れ基準
- [ ] investorTypeカラムを追加:'cold' | 'friend'(デフォルト'cold')
- [ ] マイグレーションを生成して実行
- [ ] pnpm typecheckがパスする
- [ ] pnpm lintがパスする
EOF
)" \
  --priority=1

# US-002: UIストーリー(ブラウザ確認も追加)
bd create --parent=ralph-tui-abc \
  --title="US-002: 投資家リスト行にタイプトグルを追加" \
  --description="$(cat <<'EOF'
Ryanとして、リストから直接投資家タイプを切り替えたい。

## 受け入れ基準
- [ ] 各行にCold | Friendトグルがある
- [ ] 切り替えると確認ダイアログが表示される
- [ ] 確認時:データベースのタイプを更新
- [ ] pnpm typecheckがパスする
- [ ] pnpm lintがパスする
- [ ] dev-browserスキルを使用してブラウザで確認
EOF
)" \
  --priority=2

# 依存関係を追加:US-002はUS-001に依存
bd dep add ralph-tui-002 ralph-tui-001

# US-003: UIストーリー
bd create --parent=ralph-tui-abc \
  --title="US-003: 投資家をタイプでフィルター" \
  --description="$(cat <<'EOF'
Ryanとして、フレンドまたはコールドだけを表示するようにリストをフィルターしたい。

## 受け入れ基準
- [ ] フィルタードロップダウン:すべて | コールド | フレンド
- [ ] フィルターはURLパラメータに保持される
- [ ] pnpm typecheckがパスする
- [ ] pnpm lintがパスする
- [ ] dev-browserスキルを使用してブラウザで確認
EOF
)" \
  --priority=3

# 依存関係を追加:US-003はUS-002に依存
bd dep add ralph-tui-003 ralph-tui-002

出力場所

ビーズは.beads/beads.jsonlに書き込まれます。

作成後、ralph-tuiを実行します:

# 特定のエピックで作業
ralph-tui run --tracker beads --epic ralph-tui-abc

# または、自動的に最適なタスクを選択させる
ralph-tui run --tracker beads

ralph-tuiは次のことを行います:

  1. 指定されたエピック内のビーズで作業(または利用可能な最適なタスクを選択)
  2. 各ビーズが完了したら閉じる
  3. すべての子が完了したらエピックを閉じる
  4. エピックが完了したら<promise>COMPLETE</promise>を出力

ビーズ作成前のチェックリスト

  • PRDから品質ゲートを抽出した(または欠けている場合はユーザーに尋ねた)
  • 各ストーリーが1回のイテレーションで完了可能(十分に小さい)
  • ストーリーが依存関係の順序で並んでいる(スキーマ → バックエンド → UI)
  • すべてのビーズの受け入れ基準に品質ゲートが追加されている
  • UIストーリーにブラウザ確認が含まれている(品質ゲートで指定されている場合)
  • 受け入れ基準が検証可能(曖昧でない)
  • どのストーリーも後のストーリーに依存していない(前のストーリーのみ)
  • ビーズ作成後にbd dep addで依存関係が追加されている

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

関連スキル