ralph-tui-create-beads

此技能作為高階產品需求文件 (PRD) 與 ralph-tui 所需執行任務格式之間的智慧橋樑。透過將基於 Markdown 的功能規格轉換為結構化的任務 beads，它能啟用一個維護邏輯執行順序與驗證標準的自主代理循環。此工具專為使用 ralph-tui 的開發者與技術專案經理所設計，確保 AI 代理在開發過程中遵循嚴謹且以測試為導向的方法。

該工具透過解析 PRD 中的品質閘控 (Quality Gates) 區塊來處理輸入文件，識別強制性的測試與驗證步驟。它會自動生成一個父級 epic bead 與一系列代表個別使用者故事的子任務。透過強制執行依賴邏輯，確保任務執行順序正確——通常從資料庫結構遷移、後端邏輯到前端 UI 元件——這使得代理程式能夠以增量方式建構系統，而不會遺失內容。由於 ralph-tui 在隔離的迭代中運作，此技能對於將大型功能集分解為可管理、可驗證且符合代理程式上下文視窗的單元至關重要。

• 從 PRD Markdown 文件中自動提取通用與 UI 特定的品質閘控要求。

• 使用 HEREDOC 語法生成 Shell 安全的 bd create 指令，以保留複雜的任務描述。

• 使用 bd dep add 處理依賴鏈建立，強制執行執行順序（先結構，再後端，最後 UI）。

• 透過合併特定使用者故事需求與全域品質閘控命令來定義驗收標準。

• 支援細粒度的任務拆解，以防止長時間執行代理工作流時出現上下文耗盡。

• 直接整合 beads-rust 追蹤器外掛程式與原生 beads 儲存格式。

• 請確保 PRD 包含明確的品質閘控區塊；若省略，技能將提示您輸入預設值（如 npm run typecheck）。

• 遵循「一個故事、一次迭代」原則，確保 AI 代理能在記憶體限制內完成任務。

• 將生成的 beads.jsonl 檔案作為 ralph-tui run 指令的主要任務來源。

• 輸出使用單引號 HEREDOC 定界符（cat <<'EOF'），以防止 Shell 字元干擾任務描述。

• 非常適合處理如資料庫結構更新、API 實作與 UI 元件整合等複雜功能。