建構 OSOP 生態系統：11 個儲存庫，一個願景

OSOP 不是單一工具——它是一個由 11 個儲存庫組成的生態系統，共同讓 AI Agent 工作流程可攜帶、可稽核、可最佳化。本文說明各部分如何配合以及每個部分為何存在。

架構

每個協定要成功需要三件事：乾淨的規格書、讓它有用的工具，以及讓它無處不在的生態系統。OSOP 三者兼備。

ecosystem-architecture.txt
┌─────────────────────────────────────────────────────┐
│                   OSOP Ecosystem                     │
├──────────────┬──────────────┬────────────────────────┤
│  Spec Layer  │  Tool Layer  │  Ecosystem Layer       │
│              │              │                        │
│  osop-spec   │  osop (CLI)  │  osop-agent-rules (18) │
│  (protocol)  │  osop-sdk-js │  osop-openclaw-skill   │
│              │  osop-sdk-py │  osop-interop           │
│              │  osop-mcp    │  osop-examples (39+)    │
│              │  osop-editor │  osop-website           │
│              │  osop-vscode │                        │
└──────────────┴──────────────┴────────────────────────┘

第一層：規格書

osop-spec 是協定定義。它規定 .osop 和 .osoplog YAML 格式，包括 16 種節點類型、13 種邊模式、安全後設資料和合規等級（L1-L4）。規格書經 JSON Schema 驗證——每個 .osop 檔案都可以對照機器可讀的 schema 檢查。

規格書還定義了條件邊的表達式語言（CEL）、Agent 執行環境綁定（Agent 應如何執行工作流程），以及執行報告格式。

第二層：開發者工具

Python CLI (osop)

驗證、渲染、執行和測試工作流程的命令列工具。pip install osop 給你從終端機使用 OSOP 所需的一切。它是生態系統的主力。

JavaScript SDK (osop-sdk-js)

TypeScript 優先的程式庫，用於在 Node.js 和瀏覽器中解析、驗證和操作 .osop 檔案。被視覺編輯器和任何基於 Web 的 OSOP 工具使用。

Python SDK (osop-sdk-py)

同步和非同步 Python 客戶端，用於程式化工作流程建立、驗證和執行。被 MCP 伺服器和任何需要使用 OSOP 的 Python 應用程式使用。

MCP Server (osop-mcp)

通過 Model Context Protocol 公開 9 個 OSOP 工具。這是採用加速器——安裝後，任何 MCP 相容的 AI Agent（Copilot、Cursor、Claude）都可以驗證、執行、渲染、最佳化和轉換 OSOP 工作流程，無需任何自訂整合。 MCP 深入探討

Visual Editor (osop-editor)

用於撰寫和視覺化工作流程的互動式 Web 編輯器。使用 React 19 和 ReactFlow 建構。具備 5 種視覺化模式（圖形、故事、角色、Agent、程式碼）、內建風險分析、執行重播和 AI 驅動的工作流程生成。 osop-editor.vercel.app.

VS Code Extension (osop-vscode)

語法高亮、schema 驗證、自動完成、懸停文件和 9 個 .osop 檔案程式碼片段。開發者在 IDE 中撰寫工作流程，具有完整的 IntelliSense 支援。

第三層：生態系統擴展

Agent Rules (osop-agent-rules)

18 個 AI 程式平台的即插即用指令檔案。一個 CORE-INSTRUCTIONS.md 加上 Cursor、Codex、Windsurf、Aider、Cline、Roo Code、Devin、Obsidian、Zed、Amp、Trae、PearAI、Sweep AI 和 SWE-agent 的平台專用包裝器。通用安裝器自動偵測你的工具。

OpenClaw Skill (osop-openclaw-skill)

在 ClawHub 上發布的 5 個技能——OpenClaw 的社群市場。對話日誌記錄、HTML 報告、安全審查、工作流程最佳化和核心 OSOP 技能。生態系統中有 13,000+ 個技能。

Format Converters (osop-interop)

OSOP 與 6 種外部格式之間的雙向轉換器：GitHub Actions、BPMN、Airflow、Temporal、Postman 和 OpenAPI。消除冷啟動問題——匯入你現有的工作流程，立即開始使用 OSOP。

Examples (osop-examples)

橫跨 9 個領域的 39+ 個真實世界工作流程範本：DevOps、測試、基礎設施、AI Agent、資料、API、行動、平台和商業。每個範例都是完整、有效的 .osop 檔案，可立即執行。

一切如何連接

典型的 OSOP 工作流程如下：

在 VS Code（具自動完成）或視覺編輯器中撰寫 .osop 檔案
使用 CLI（osop validate）或 MCP 伺服器進行驗證
使用任何 AI Agent 執行——Agent 規則教它產生 .osoplog 檔案
在視覺編輯器中分析執行——風險覆蓋、逐步重播
通過比較 .osop 與 .osoplog 進行最佳化——找出需要改進的地方
如有需要匯出到 GitHub Actions、Airflow 或 BPMN——OSOP 可互通

開源、模組化、可組合

每個儲存庫都是 Apache 2.0。每個元件獨立運作——你可以不用編輯器只用 CLI，不用 MCP 伺服器只用 SDK，不用 CLI 只用 Agent 規則。但它們設計為協同工作，整體大於部分之和。

生態系統是護城河。當 AI Agent 讀寫 OSOP，當工具驗證和渲染它，當平台匯入和匯出它——協定就成為基礎設施。基礎設施就成為標準。

架構