Communitygithub.com

ComeOnOliver/skillshub

将 PRD 转换为 beads,用于 ralph-tui 执行。为每个用户故事创建一个包含子 beads 的 epic。当你有 PRD 并希望将 beads 作为任务源使用 ralph-tui 时使用。触发条件:创建 beads、将 PRD 转换为 beads、为 ralph 创建 beads、ralph beads。

skillshub 是什么?

该技能用于将产品需求文档(PRD)自动转换为 ralph-tui 可执行的 beads 任务格式。它首先从 PRD 中提取“质量门”(Quality Gates),然后根据用户故事创建层级分明的任务结构:一个 epic bead 作为根节点,每个用户故事对应一个子 bead。技能确保每个故事足够小,可在 ralph-tui 的单个迭代(即单个 agent 上下文窗口)内完成,并按照依赖关系(schema → 后端 → UI)正确排序。它使用 `bd create` 命令配合 HEREDOC 语法安全处理特殊字符,并通过 `bd dep add` 设置依赖。该技能特别适合需要将 PRD 中的功能拆解为可独立验证、顺序执行的任务场景,支持 ralph-tui 的 Beads tracker 插件。

兼容平台~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(epic + 子任务),用于 ralph-tui 自主执行。

注意: 此技能已与 ralph-tui 的 Beads tracker 插件捆绑。未来的 tracker 插件(Linear、GitHub Issues 等)将捆绑自己的任务创建技能。


任务

获取 PRD(markdown 文件或文本)并在 .beads/beads.jsonl 中创建 beads:

  1. 提取质量门:从 PRD 的“质量门”部分提取
  2. 为功能创建一个 epic bead
  3. 为每个用户故事创建 子 beads(附加质量门)
  4. 设置 beads 之间的 依赖关系(schema → 后端 → UI)
  5. 输出准备用于 ralph-tui run --tracker beads

第1步:提取质量门

在 PRD 中查找“质量门”部分:

## 质量门

每个用户故事都必须通过以下命令:
- `pnpm typecheck` - 类型检查
- `pnpm lint` - 代码检查

对于 UI 故事,还需包括:
- 使用 dev-browser 技能在浏览器中验证

提取:

  • 通用门: 适用于所有故事的命令(例如 pnpm typecheck)
  • UI 门: 仅适用于 UI 故事的命令(例如浏览器验证)

如果没有质量门部分: 询问用户应该通过哪些命令,或使用合理的默认值如 npm run typecheck。


输出格式

Beads 使用 bd create 命令配合 HEREDOC 语法 以安全处理特殊字符:

# 创建 epic(链接回源 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 解释描述中的反引号、$variables 和 ()。


故事大小:头号规则

每个故事必须能在一次 ralph-tui 迭代(约一个 agent 上下文窗口)内完成。

ralph-tui 每次迭代都会生成一个新的 agent 实例,且不保留之前工作的记忆。如果故事太大,agent 会在完成之前耗尽上下文。

适当大小的故事:

  • 添加数据库列 + 迁移
  • 向现有页面添加 UI 组件
  • 使用新逻辑更新 server action
  • 向列表添加筛选下拉框

太大(需要拆分):

  • “构建整个仪表盘” → 拆分为:schema、查询、UI 组件、筛选器
  • “添加身份验证” → 拆分为:schema、中间件、登录 UI、会话处理
  • “重构 API” → 拆分为每个端点或模式一个故事

经验法则: 如果你不能用 2-3 句话描述更改,则故事太大。


故事排序:依赖优先

故事按依赖顺序执行。较早的故事不能依赖于较晚的故事。

正确顺序:

  1. Schema/数据库更改(迁移)
  2. Server actions/后端逻辑
  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 依赖于 block-er)
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 的质量门部分(附加在末尾)

好的标准(可验证):

  • “在 investor 表中添加 investorType 列,默认值为 'cold'”
  • “筛选下拉框具有选项:全部、Cold、Friend”
  • “点击切换开关显示确认对话框”

差的标准(模糊):

  • ❌ “工作正常”
  • ❌ “用户可以轻松做 X”
  • ❌ “良好的用户体验”
  • ❌ “处理边缘情况”

转换规则

  1. 首先从 PRD 提取质量门
  2. 每个用户故事 → 一个 bead
  3. 第一个故事:无依赖(创建基础)
  4. 后续故事:依赖于前一个故事(UI 依赖于后端等)
  5. 优先级:基于依赖顺序,然后文档顺序(0=关键,2=中,4=待办)
  6. 所有故事:status: "open"
  7. 验收标准:故事标准 + 附加质量门
  8. UI 故事:还要附加 UI 特定的门(浏览器验证)

拆分大型 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:更新仪表盘计数

每个都是一个专注的更改,可以独立完成和验证。


示例

输入 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,我想筛选列表以仅查看朋友或 cold。

**验收标准:**
- [ ] 筛选下拉框:全部 | Cold | Friend
- [ ] 筛选条件在 URL 参数中持久化

输出 beads:

# 创建 epic(链接回源 PRD)
bd create --type=epic \
  --title="朋友外联通道" \
  --description="$(cat <<'EOF'
用于 Deck 反馈的暖外联
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。

## 验收标准
- [ ] 筛选下拉框:全部 | 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:

# 处理特定 epic
ralph-tui run --tracker beads --epic ralph-tui-abc

# 或让它自动选择最佳任务
ralph-tui run --tracker beads

ralph-tui 会:

  1. 处理指定 epic 内的 beads(或选择最佳可用任务)
  2. 每个 bead 完成后关闭它
  3. 所有子任务完成后关闭 epic
  4. epic 完成后输出 <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

相关技能