Communitygithub.com

ComeOnOliver/skillshub

為 ralph-tui 任務協調工具生成產品需求文件(PRD)。建立包含用戶故事的 PRD,可轉換為 beads issues 或 prd.json 以進行自動化執行。觸發詞:建立 prd、為...撰寫 prd、規劃此功能、需求、規格。

skillshub 是什麼?

此技能專為 AI 代理與 ralph-tui 工作流程設計,主要功能是根據使用者提供的功能描述,生成結構化的產品需求文件(PRD)。它會透過反覆提問的方式,引導使用者釐清功能的目標、核心邏輯、範圍邊界、成功標準以及整合方式,並強制要求指定通過的品質檢查指令(例如 `pnpm typecheck && pnpm lint`),以確保每個用戶故事皆可被機器驗證。 技能支援多輪適應性問答,每次僅提出一組含有字母選項的問題(如「1A, 2C」),使用者可快速回覆,助理再根據答案決定是否追問或直接產出 PRD。最終的 PRD 會包含概述、目標、品質閘門、用戶故事、功能需求、非目標、技術考量與成功指標等章節,並以 `[PRD]...[/PRD]` 標記包裹,供 ralph-tui 自動解析與儲存至 `./tasks/prd-[feature-name].md`。 這樣的設計讓開發團隊與 AI 代理能夠以可重複、標準化的方式將想法轉化為可執行的規格,特別適合需要頻繁協作與自動化執行的專案環境。

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

在你喜歡的 AI 中提問

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

說明文件

Ralph TUI PRD 產生器

建立針對 AI agent 透過 ralph-tui 執行而最佳化的詳細產品需求文件。


任務

  1. 從使用者接收功能說明
  2. 提出 3-5 個必要的釐清問題(附有字母選項)——每次一組
  3. 務必詢問品質關卡(指令必須通過)
  4. 每個答案後,必要時提出後續問題(自適應探索)
  5. 在擁有足夠上下文時,產生結構化的 PRD
  6. 輸出被 [PRD]...[/PRD] 標記包裹的 PRD,以供 TUI 解析

重要: 不要開始實作。只需建立 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 skill 進行視覺驗證
   B. 否,自動化測試已足夠

自適應提問

每次回覆後,決定是否要:

  • 提出後續問題(如果答案顯示複雜性)
  • 詢問新的方面(如果當前領域已清楚)
  • 產生 PRD(如果你有足夠的上下文)

通常需要 2-4 輪的問題。


步驟 2:PRD 結構

使用以下章節產生 PRD:

1. 簡介/概述

功能的簡要描述以及它解決的問題。

2. 目標

具體、可衡量的目標(項目符號列表)。

3. 品質關卡

關鍵: 列出每個使用者故事都必須通過的指令。

## 品質關卡

這些指令必須通過每個使用者故事:
- `pnpm typecheck` - 型別檢查
- `pnpm lint` - Linting

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

此章節會被轉換工具(ralph-tui-create-json、ralph-tui-create-beads)擷取,並附加到每個故事的驗收標準。

4. 使用者故事

每個故事需要:

  • 標題: 簡短的描述性名稱
  • 描述: 「身為一個 [使用者],我想要 [功能] 以便 [效益]」
  • 驗收標準: 可驗證的核取清單,說明「完成」的定義

每個故事應夠小,以便在一個專注的 AI agent 會話中實作。

格式:

### US-001:[標題]
**描述:** 身為一個 [使用者],我想要 [功能] 以便 [效益]。

**驗收標準:**
- [ ] 特定的可驗證標準
- [ ] 另一個標準

注意: 請勿在個別故事標準中包含品質關卡指令——它們在品質關卡章節中一次性定義,並在轉換過程中自動套用。

重要:

  • 驗收標準必須是可驗證的,而非含糊不清
  • 「正常運作」是不好的
  • 「按鈕在刪除前顯示確認對話框」是好的
  • 每個故事應可獨立完成

5. 功能需求

編號的具體功能列表:

  • 「FR-1:系統必須允許使用者...」
  • 「FR-2:當使用者點擊 X 時,系統必須...」

要明確且無歧義。

6. 非目標(超出範圍)

此功能將不包含的內容。對於管理範圍至關重要。

7. 技術考量(選擇性)

  • 已知的限制或依賴關係
  • 與現有系統的整合點
  • 效能要求

8. 成功指標

如何衡量成功?

9. 未解決的問題

殘留的問題或需要釐清的領域。


為 AI Agent 撰寫

PRD 將由 AI 編碼 agent 透過 ralph-tui 執行。因此:

  • 要明確且無歧義
  • 使用者故事應小(可在一個會話中完成)
  • 驗收標準必須在可能的情況下可被機器驗證
  • 如果知道,請包含特定的檔案路徑
  • 參考專案中現有的程式碼模式

輸出格式

關鍵: 將最終的 PRD 包裹在標記中,以供 TUI 解析:

[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 skill B. 否,自動化測試已足夠

使用者: 3A, 4A, 5A

助理: 完美,我已有足夠資訊來產生 PRD。

[PRD]

PRD:Ralph TUI 深色模式

概述

為 ralph-tui 加入深色模式支援,以減輕長時間排程會話期間的眼睛疲勞。此功能將套用至所有 TUI 元件,並將使用者的偏好儲存在設定檔中。

目標

  • 在低光源環境下提供舒適的觀看體驗
  • 跨會話持續保存主題偏好
  • 對所有 TUI 元件套用一致的樣式

品質關卡

這些指令必須通過每個使用者故事:

  • pnpm typecheck - 型別檢查
  • pnpm lint - Linting

對於 UI 故事,也需包含:

  • 使用 dev-browser 技能在瀏覽器中驗證

使用者故事

US-001:加入主題設定

描述: 身為一個使用者,我想要設定我的偏好的主題(淺色/深色),以便它跨會話持續保存。

驗收標準:

  • 將 theme 欄位加入 .ralph-tui.yaml 架構
  • 支援值:「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

相關技能