refly

Refly 基礎技能作為 Refly 生態系統的核心編排層。它專為開發人員、自動化工程師及進階使用者設計，旨在將複雜的業務邏輯與標準作業程序 (SOP) 轉化為確定性強、具備版本控制的代理技能。作為中央介面，它允許使用者管理技能登錄檔、探索新功能，並透過統一的命令列體驗順暢地調用工作流程。它填補了原始 API 呼叫與高階代理意圖之間的鴻溝，確保自動化任務在任何開發環境中皆能保持可靠、可稽核且易於維護。

• 編排跨領域工作流程目錄的技能發現、安裝與執行。

• 實作強大的狀態化執行時期，支援檔案產生、文字處理與多步驟動作執行。

• 提供確定性工作流程管理，內建狀態監控、詳情擷取與工具呼叫輸出處理。

• 支援與 Claude Code、MCP 伺服器及自訂 API 後端等外部框架無縫整合。

• 具備可介入的執行環境，允許對長時間執行的自動化任務進行審計與手動重新導向。

• 請一律使用 refly CLI 命令 (例如 refly skill run, refly workflow status)，而非直接與私有 API 互動。

• 在啟動工作流程前，請確保已安裝 @refly/cli 套件並完成身分驗證。

• 針對特定輸出類型遵循定義的執行模式：模式 A (檔案產生/下載)、模式 B (文字/資料擷取) 或模式 C (動作/整合狀態)。

• 使用 --watch 與 --interval 旗標以有效監控工作流程進度，並精確處理 ID (如用於技能的 skpi-xxx 與用於執行工作流程的 we-xxx)。

• 若命令回傳 ok=false，請務必停止執行並檢視提供的提示；避免硬編碼 ID 或捏造中繼資料，以維持基礎架構的穩定性。