OSOP 現在支援 18 個 AI 程式平台。本文說明 OSOP 的功能、如何與各平台整合，以及為什麼通用工作流程協定很重要。
什麼是 OSOP？
OSOP（Open Standard Operating Procedures）是兩種 YAML 格式：
.osop— .osop — 工作流程定義。描述應該發生什麼：節點（16 種類型）、邊（13 種模式）、安全後設資料、核准閘門。.osoplog— .osoplog — 執行記錄。描述實際發生了什麼：時間戳記、工具呼叫、token 數量、AI 推理、人工決策。
兩者共同形成封閉迴圈：定義、執行、記錄、最佳化。
為什麼這很重要？
沒有 OSOP，每次 AI 程式對話都是一個黑箱。Agent 做了「某些事」，你得到了結果。如果出錯，你翻閱聊天記錄。如果成功，你無法重現。沒有稽核軌跡，沒有最佳化數據，沒有辦法與使用不同工具的同事分享工作流程。
OSOP 改變了這一切。每次對話都產生結構化、可攜帶的記錄，適用於所有 18 個平台。
逐平台整合
第一層：原生整合
這些平台擁有第一級 OSOP 支援，具備技能系統或外掛。
| 平台 | 整合方式 | 安裝方式 |
|---|---|---|
| Claude Code | 原生外掛，5 個斜線命令 | claude /install-plugin https://github.com/Archie0125/osop-skill |
| OpenClaw | ClawHub 註冊表上的 5 個技能 | clawhub install osop |
| GitHub Copilot | MCP 伺服器整合 | pip install osop-mcp |
第二層：規則檔案整合
這些平台讀取 markdown 指令檔。放入一個檔案，OSOP 即可運作。
| 平台 | 檔案 | 位置 |
|---|---|---|
| Cursor | .mdc rule | .cursor/rules/osop-session-logging.mdc |
| Codex | AGENTS.md | Project root |
| Windsurf | .md rule | .windsurf/rules/osop-session-logging.md |
| Continue.dev | YAML rule | .continue/rules/osop-session-logging.yaml |
| Aider | CONVENTIONS.md | Project root |
| Cline | .md rule | .clinerules/osop-session-logging.md |
| Roo Code | .md rule | .roo/rules/osop-session-logging.md |
| Devin | Playbook | playbooks/osop-session-logging.md |
| Zed | .rules | Project root |
| Sourcegraph Amp | AGENT.md | Project root |
| Trae | project_rules.md | Project root |
第三層：設定型整合
| 平台 | 整合方式 |
|---|---|
| Obsidian | Custom prompt in .obsidian/copilot-custom-prompts/ |
| PearAI | Custom slash command in config.json |
| Sweep AI | SKILL.md in .claude/skills/ |
| SWE-agent | YAML config with system_template |
通用安裝器
不想弄清楚哪個檔案放哪裡？通用安裝器會處理：
install.sh
git clone https://github.com/Archie0125/osop-agent-rules.git cd osop-agent-rules ./install.sh # auto-detects your tools ./install.sh --all # installs for everything
安裝器檢查設定目錄（.cursor/、.windsurf/、.clinerules/ 等），只為你實際擁有的工具安裝。除非傳入 --force，否則不會覆蓋現有檔案。
你會得到什麼
當你的 AI Agent 完成多步驟任務後，它會自動產生兩個檔案：
session-files
sessions/2026-04-01-fix-auth-bug.osop # What should have happened sessions/2026-04-01-fix-auth-bug.osoplog.yaml # What actually happened
你可以：
- 視覺化 — 將兩個檔案拖入編輯器，取得互動式節點圖
- 分析 — 執行風險分析，找出缺少的核准閘門或破壞性命令
- 最佳化 — 比較多次執行記錄，找出慢步驟和故障熱點
- 稽核 — 每個 AI 動作、工具呼叫和人工決策的結構化證據
- 分享 — 可攜帶的 YAML 檔案，適用於任何 OSOP 相容工具
OSOP 生態系統
| 元件 | 功能 |
|---|---|
| Spec v1.0 | .osop 和 .osoplog 格式的 JSON Schema |
| Visual Editor | 互動式節點圖、風險分析、執行重播 |
| Python CLI | pip install osop — 驗證、渲染、執行 |
| JS/TS SDK | 在 Node.js 中解析和操作 .osop 檔案 |
| Python SDK | 用於工作流程建立和驗證的 Python 程式庫 |
| 39+ Examples | DevOps、AI Agent、資料管線、事件回應 |
| Agent Rules | 18 個平台的即插即用檔案 |
| ClawHub Skills | OpenClaw 生態系統的 5 個技能 |
| MCP Server | Copilot、Cursor、Claude 的 Model Context Protocol |
開始使用
get-started.sh
# Install the CLI pip install osop # Or use the agent rules for your AI tool git clone https://github.com/Archie0125/osop-agent-rules.git cd osop-agent-rules && ./install.sh # Or install as a Claude Code plugin claude /install-plugin https://github.com/Archie0125/osop-skill # Or install on OpenClaw clawhub install osop
OSOP 是開源的（Apache 2.0）。規格書、SDK、編輯器和所有整合都是免費的。我們希望 OSOP 像 JSON Schema 一樣普及和無所不在。