Communitygithub.com

ComeOnOliver/skillshub

將 PRD 轉換為 beads,以便在 ralph-tui 中執行。為每個用戶故事建立一個史詩(epic)與子 beads。當你有一份 PRD 並想使用 ralph-tui 搭配 beads 作為任務來源時使用。觸發條件:建立 beads、將 PRD 轉換為 beads、為 ralph 建立 beads、ralph beads。

skillshub 是什麼?

這個技能會自動將產品需求文件(PRD)轉換成 `ralph-tui` 可以執行的結構化任務 bead。它會從 PRD 中提取「品質關卡」(Quality Gates),為整個功能建立一個史詩級(epic)bead,並為每個使用者故事建立一個子 bead,同時將品質關卡附加到驗收條件中。這個技能支援以檔案或純文字形式傳入的 PRD,並處理依賴關係(例如 schema → 後端 → UI),確保任務以正確的順序執行。它會產生一個 `.beads/beads.jsonl` 檔案,然後你可以使用 `ralph-tui run --tracker beads` 來執行。這個技能專門為 `ralph-tui` 的 Beads 追蹤插件設計,並確保每個故事的規模都適合在單個代理程式上下文視窗中完成。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Ralph TUI - 建立 Beads

將 PRD 轉換為 beads(史詩 + 子任務),以供 ralph-tui 自主執行。

注意: 此技能隨 ralph-tui 的 Beads 追蹤插件一同提供。未來的追蹤插件(Linear、GitHub Issues 等)將會附帶各自的任務建立技能。


工作內容

接收一份 PRD(Markdown 檔案或文字),並在 .beads/beads.jsonl 中建立 beads:

  1. 提取品質關卡:從 PRD 的「品質關卡」章節中提取
  2. 為該功能建立一個史詩(epic)bead
  3. 為每個使用者故事建立子 bead(並附加品質關卡)
  4. 設定 beads 之間的依賴關係(schema → 後端 → UI)
  5. 產生可供 ralph-tui run --tracker beads 使用的輸出

第一步:提取品質關卡

在 PRD 中尋找「品質關卡」章節:

## 品質關卡

每個使用者故事都必須通過以下指令:
- `pnpm typecheck` - 型別檢查
- `pnpm lint` - 程式碼檢查

對於 UI 故事,也需包含:
- 使用 dev-browser 技能在瀏覽器中驗證

提取:

  • 通用關卡: 適用於所有故事的指令(例如 pnpm typecheck)
  • UI 關卡: 僅適用於 UI 故事的指令(例如瀏覽器驗證)

如果沒有「品質關卡」章節: 詢問使用者應該通過哪些指令,或使用合理的預設值,例如 npm run typecheck。


輸出格式

Beads 使用 bd create 指令搭配 HEREDOC 語法,以安全處理特殊字元:

# 建立史詩(連結回原始 PRD)
bd create --type=epic \
  --title="[功能名稱]" \
  --description="$(cat <<'EOF'
[來自 PRD 的功能描述]
EOF
)" \
  --external-ref="prd:./tasks/feature-name-prd.md"

# 建立子 bead(將品質關卡包含在驗收條件中)
bd create \
  --parent=EPIC_ID \
  --title="[故事標題]" \
  --description="$(cat <<'EOF'
[包含驗收條件及品質關卡的故事描述]
EOF
)" \
  --priority=[1-4]

重要: 務必使用 <<'EOF'(單引號)作為 HEREDOC 分隔符號。這可以避免 Shell 解譯描述中的反引號、$變數 和 ()。


故事規模:第一原則

每個故事必須能在一次 ralph-tui 迭代中完成(約一個代理程式上下文視窗)。

ralph-tui 每次迭代都會產生一個全新的代理程式實例,不會記憶先前的工作。如果故事太大,代理程式會在完成前耗盡上下文。

規模適當的故事:

  • 新增資料庫欄位 + 遷移
  • 在現有頁面新增 UI 元件
  • 更新伺服器動作並加入新邏輯
  • 在清單中新增篩選下拉選單

太大的故事(請拆分):

  • 「建立整個儀表板」→ 拆分成:schema、查詢、UI 元件、篩選器
  • 「新增身分驗證」→ 拆分成:schema、中介軟體、登入 UI、工作階段處理
  • 「重構 API」→ 依端點或模式拆分成一個故事

經驗法則: 如果你無法用 2-3 句話描述變更內容,那就表示故事太大了。


故事順序:先處理依賴關係

故事會按照依賴關係順序執行。較早的故事不能依賴較晚的故事。

正確順序:

  1. Schema/資料庫變更(遷移)
  2. 伺服器動作 / 後端邏輯
  3. 使用後端的 UI 元件
  4. 匯聚資料的儀表板/摘要畫面

錯誤順序:

  1. ❌ UI 元件(依賴於尚未存在的 schema)
  2. ❌ Schema 變更

使用 bd dep add 設定依賴關係

使用 bd dep add 指令來指定哪些 beads 必須先完成:

# 先建立 beads
bd create --parent=epic-123 --title="US-001: 新增 schema" ...
bd create --parent=epic-123 --title="US-002: 建立 API" ...
bd create --parent=epic-123 --title="US-003: 建立 UI" ...

# 然後新增依賴關係(issue depends-on blocker)
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 會:

  • 在依賴關係完成前,將被封鎖的 beads 顯示為「blocked」
  • 絕不會在依賴項仍處於開啟狀態時選取 bead 來執行
  • 在處理 bead 時,於提示中包含依賴關係的上下文

正確的依賴關係順序:

  1. Schema/資料庫變更(無依賴關係)
  2. 後端邏輯(依賴 schema)
  3. UI 元件(依賴後端)
  4. 整合/打磨(依賴 UI)

驗收條件:品質關卡 + 故事專屬條件

每個 bead 的描述應包含驗收條件,其中需有:

  1. 故事專屬條件:來自 PRD(此故事要完成的事項)
  2. 品質關卡:來自 PRD 的品質關卡章節(附加在結尾)

良好的條件(可驗證):

  • 「將 investorType 欄位新增至 investor 資料表,預設值為 'cold'」
  • 「篩選下拉選單包含選項:全部、Cold、Friend」
  • 「點擊切換開關會顯示確認對話框」

不良條件(模糊):

  • ❌ 「運作正常」
  • ❌ 「使用者可以輕鬆進行 X」
  • ❌ 「良好的使用者體驗」
  • ❌ 「處理邊緣情況」

轉換規則

  1. 先從 PRD 中提取品質關卡
  2. 每個使用者故事 → 一個 bead
  3. 第一個故事:無依賴關係(建立基礎)
  4. 後續的故事:依賴於前一個故事(UI 依賴後端,以此類推)
  5. 優先級:根據依賴關係順序,然後是文件中的順序(0=關鍵,2=中等,4=待辦)
  6. 所有故事:status: "open"
  7. 驗收條件:故事條件 + 附加的品質關卡
  8. UI 故事:也需附加 UI 專屬關卡(瀏覽器驗證)

拆分大型 PRD

如果 PRD 中有大型功能,請拆分它們:

原始內容:

「新增朋友 outreach 追蹤,並包含不同的訊息功能」

拆分後:

  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:更新儀表板計數

每個都是一個專注的變更,可以獨立完成和驗證。


範例

輸入 PRD:

# PRD:朋友 Outreach

新增將投資者標記為「朋友」以進行溫暖 outreach 的功能。

## 品質關卡

每個使用者故事都必須通過以下指令:
- `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,我想要篩選清單,只查看朋友或冷門投資者。

**驗收條件:**
- [ ] 篩選下拉選單:全部 | Cold | Friend
- [ ] 篩選條件保留在 URL 參數中

輸出 beads:

# 建立史詩(連結回原始 PRD)
bd create --type=epic \
  --title="朋友 Outreach 追蹤" \
  --description="$(cat <<'EOF'
用於 Deck 回饋的溫暖 outreach
EOF
)" \
  --external-ref="prd:./tasks/friends-outreach-prd.md"

# US-001:無依賴關係(第一個,建立 schema)
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,我想要篩選清單,只查看朋友或冷門投資者。

## 驗收條件
- [ ] 篩選下拉選單:全部 | Cold | Friend
- [ ] 篩選條件保留在 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/beads.jsonl

建立完成後,執行 ralph-tui:

# 處理特定史詩
ralph-tui run --tracker beads --epic ralph-tui-abc

# 或讓它自動選取最佳任務
ralph-tui run --tracker beads

ralph-tui 會:

  1. 處理指定史詩內的 beads(或選取最佳可用任務)
  2. 完成時關閉每個 bead
  3. 所有子任務完成後關閉史詩
  4. 史詩完成時輸出 <promise>COMPLETE</promise>

建立 Beads 前的檢查清單

  • 已從 PRD 提取品質關卡(若遺漏則已詢問使用者)
  • 每個故事都能在一次迭代中完成(夠小)
  • 故事已按依賴關係排序(schema → 後端 → UI)
  • 每個 bead 的驗收條件都已附加品質關卡
  • UI 故事已包含瀏覽器驗證(若品質關卡中有指定)
  • 驗收條件是可驗證的(不模糊)
  • 沒有故事依賴於較晚的故事(僅依賴較早的故事)
  • 建立 beads 後已使用 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

相關技能