核心功能
The Loop
執行工作流程。記錄結果。讓 AI 寫出更好的版本。重複。每次循環，你的流程都更快、更省、更可靠。
.osop 定義該發生什麼。.osoplog 記錄實際發生了什麼。兩者之間的差距就是優化的空間。
pip install osop1
執行
使用 osop run 執行 .osop 工作流程。Agent 節點呼叫真正的 LLM。CLI 節點執行命令。Human 節點等待核准。
osop run workflow.osop --allow-exec2
記錄
自動產生 .osoplog。每個節點：持續時間、成本、狀態、工具呼叫、AI 推理過程、人類決策。
# .osoplog.yaml generated3
合成
將多個 .osoplog 檔案餵給 AI。AI 分析模式並寫出更好的 .osop。慢步驟平行化。失敗點處理。
osop synthesize *.osoplog.yaml4
比較 & 重複
用 osop diff 比較執行結果。看哪些變快了、變便宜了、還是壞了。套用優化後的 .osop。再次執行。循環永不停止。
osop diff run-v1.osoplog run-v2.osoplog工具
osop diff 比較執行結果。osop synthesize 從執行資料寫出更好的工作流程。
osop diff — 比較兩次執行
osop-diff-output.txt
$ osop diff monday.osoplog tuesday.osoplog 工作流程: feature-build 執行 A: Mon Apr 1 | 執行 B: Tue Apr 2 節點 | 持續時間 | 成本 | 狀態 ───────────────────────────────────────────────────────────── 規劃 [AI] | 2.1s → 1.8s | $0.02 → $0.01 | 不變 探索 [AI] | 12s → 5.2s | $0.08 → $0.03 | 不變 實作 [AI] | 45s → 32s | $0.15 → $0.12 | 不變 型別檢查 [CI] | 3.2s → 3.1s | — | 不變 審核 [Human] | 120s → 60s | — | 不變 ───────────────────────────────────────────────────────────── 合計 | 182s → 102s | $0.25 → $0.16 | -44%
osop synthesize — AI 寫出更好的工作流程
optimized-feature-build.osop.yaml
規劃實作agent
AI 發現：有規劃的會話完成更快。
↓parallel→ 探索程式碼庫
↓parallel→ 探索測試
探索程式碼庫mcp
與測試探索平行讀取原始碼檔案。
↓sequential→ 撰寫程式碼
探索測試mcp
在撰寫程式碼前先理解現有測試模式。
撰寫程式碼agent
根據規劃與探索結果產生實作。
↓sequential→ 型別檢查
型別檢查cicd
即時驗證。每次編輯後執行，迴歸率 0%。
↓fallback→ 撰寫程式碼
↓sequential→ 執行測試
執行測試cicd
完整測試套件。
↓sequential→ 風險評估
風險評估agent
AI 發現：能捕捉測試遺漏的安全問題。
↓sequential→ 提交變更
提交變更git
僅在風險審查通過後提交。
9 個 CLI 指令
從建立到合成，一應俱全。
osop run以真正的 LLM 呼叫執行，附帶安全閘門與成本控制
osop diff比較兩次執行或兩個定義
osop synthesize將日誌餵給 AI，取得優化的工作流程
osop validate依據 JSON Schema 檢查 .osop
osop validate-log檢查 .osoplog 檔案
osop init從 5 個範本建立新工作流程
osop render產生 Mermaid、ASCII 或 SVG 圖表
osop test執行工作流程中定義的測試案例
osop report產生 HTML 執行報告