用途:把 PRD(Markdown 文件或文本)转换为扁平的 GitHub Issues,供 ralph-tui 自主执行,使用 GitHub Issues 作为任务跟踪器,通过 gh CLI 和 GraphQL API 实现原生依赖跟踪。若偏好本地跟踪(beads-rust),应改用 ralph-tui-create-beads-rust 技能。
主要能力:先从 PRD 的 Quality Gates 部分提取质量门禁(通用门禁与 UI 门禁);每个用户故事创建一个 issue,正文包含描述、验收标准(故事专属标准加质量门禁)和 Blocked by 部分;所有 issue 共享同一 feature:<slug> 标签用于分组;通过 GraphQL addBlockedBy mutation 添加 issue 间原生依赖;按依赖顺序再按文档顺序分配 priority:N(0-4)标签。
使用方式:用 gh issue create 配合 HEREDOC 创建 issue,必须使用 <<'EOF'(单引号)防止 shell 解释反引号、变量和括号;从输出 URL 末段解析 issue 编号,用 gh issue view <number> --json id --jq .id 获取 node ID;依赖用 gh api graphql 的 addBlockedBy mutation 添加,issueId 为被阻塞方,blockingIssueId 为阻塞方。创建后运行 ralph-tui run --tracker github --labels "feature:<slug>",或 ralph-tui run --tracker github 自动选择任务。
适用场景:需要把 PRD 拆分为可在一个 ralph-tui 迭代(约一个 agent 上下文窗口)内完成的小故事,并按 schema→后端→UI 的依赖顺序组织。
限制与注意:故事过大需拆分,若无法用两三句话描述变更则太大;验收标准须可验证,避免“工作正常”等模糊表述;每个 issue 正文需含 Blocked by 引用;addBlockedBy 返回类型无 blockedByIssue 字段,应使用 clientMutationId;内联 GraphQL 若报 UNKNOWN_CHAR,可写入临时文件后用 -F query=@file。具体收费、平台支持等信息暂未提供。