block/trailblaze

它解決的問題

Trailblaze 提供了一種讓 AI 編碼代理以自然語言控制真實裝置（iOS、Android 和網頁）的方法。它彌補了代理撰寫程式碼的能力與與即時應用程式 UI 互動能力之間的差距，讓開發者能使用代理驅動應用程式，將這些互動記錄為可確定性的測試，並透過 AI 驅動的自我修復功能維護測試。

如何運作

Trailblaze 提供一個 CLI，讓編碼代理（如 Claude Code、Cursor 或 Goose）可以與裝置互動。代理使用 snapshot 讀取 UI 樹，並使用 tool 對特定元件進行操作。這些會話會以「路徑」（trails）的形式儲存——即 YAML 檔案，記錄自然語言意圖與平台特定的操作。這些路徑可於 CI 中以確定性方式重播，無需 LLM；也可使用 --self-heal 標記重新執行，由內建代理自動修復微小的 UI 變更。

適用對象

專為使用 AI 編碼代理自動化跨平台移動與網頁應用程式端對端測試的開發者與 QA 工程師設計。

主要特色

• 跨平台控制：支援 iOS、Android 和網頁，具備原生還原度，暴露完整的可存取性樹狀結構或 DOM，而非有限的功能交集。
• 代理就緒技能：內建可攜式的 SKILL.md 格式，教導代理如何使用 CLI，確保代理明確知道如何驅動裝置。
• 確定性重播：將 AI 驅動的會話轉換為已提交的 YAML 路徑，在 CI 中執行時無需在執行階段依賴 LLM。
• AI 驅動的自我修復：在重播時自動修復微小的 UI 偏移（如文字變更或彈出視窗），防止測試因脆弱而失敗。
• 自訂工具：允許開發者以 TypeScript 定義類型化的自訂指令（例如 login 或 addToCart），以支援更複雜的代理互動。
• 追蹤檢視器：瀏覽器-based 的報告檢視器，為每次執行的每一步提供截圖、檢視階層結構與影片。