核心功能

SOP Doc

API Doc 展示每個端點。SOP Doc 展示整個序列 — 哪些步驟、什麼順序、誰參與其中。點選 Visual 查看流程圖。

SOP Doc 如何運作

sop-doc-browse.osop.yaml
撰寫 .osop 檔案human

以 YAML 定義流程。每個步驟是一個節點(api、agent、human、cli)。連接是邊。

sequentialosop validate
osop validatecli

依據 JSON Schema 檢查 .osop 檔案。在任何人看到之前先攔截錯誤。

sequential在 SOP Doc 瀏覽
fallback撰寫 .osop 檔案
在 SOP Doc 瀏覽mcp

開啟 osop.ai/sop-doc。Visual 分頁顯示流程圖。YAML 分頁顯示規格。

sequential與團隊分享
與團隊分享human

PM 看 Visual 分頁。工程師看 YAML。所有人看到同一個流程。

優化迴路

the-loop.osop.yaml
osop runcli

執行工作流程。Agent 節點呼叫 LLM。API 節點發送 HTTP 請求。

sequential產生 .osoplog
產生 .osoplogsystem

每個節點:時間戳記、持續時間、成本、使用的工具、AI 推理、人類決策。

sequentialosop synthesize
osop synthesizeagent

將多個 .osoplog 餵給 AI。AI 寫出優化的 .osop。

sequentialosop diff
osop diffcli

比較新舊版本。查看變化:持續時間、成本、每步驟狀態。

sequential人類審核
人類審核human

接受、修改或拒絕 AI 建議。由人類決定。

looposop run

Stripe 支付流程(API SOP)

stripe-payment-flow.osop.yaml
POST /v1/customersapi

建立 Stripe 客戶,包含電子郵件與中繼資料。

sequentialPOST /v1/payment_intents
POST /v1/payment_intentsapi

建立支付意圖。金額、幣別、客戶 ID。

sequentialPOST /v1/payment_intents/{id}/confirm
POST /v1/payment_intents/{id}/confirmapi

以支付方式確認付款。

sequentialGET /v1/payment_intents/{id}
fallbackPOST /v1/payment_intents
GET /v1/payment_intents/{id}api

驗證付款是否成功。檢查狀態欄位。

conditionalAI 產生收據
AI 產生收據agent

AI 根據付款明細產生個人化收據電子郵件。

匯入現有工作流程

import-existing.osop.yaml
辨識來源格式human

GitHub Actions、Airflow、n8n、CrewAI、Argo 或 LangGraph。

sequentialosop import
osop importcli

轉換為 OSOP 格式。將 jobs/operators/tasks 對應到 OSOP 節點與邊。

sequentialosop validate
osop validatecli

驗證轉換後的檔案是否為有效的 OSOP。

fallbackosop import
sequential在編輯器中檢視
在編輯器中檢視human

在視覺化編輯器中開啟。確認流程與原始版本一致。如需調整。

會話記錄:完整繁中國際化

session-i18n-zh-tw.osop.yaml
使用者要求完整中文翻譯human

使用者發現切換中文後仍有許多區域顯示英文。

sequential探索 i18n 架構
探索 i18n 架構agent

探索 next-intl 設定、訊息檔案、路由設定及所有頁面元件。

sequential識別未翻譯字串
識別未翻譯字串agent

在首頁、optimize、sop-doc、hub、OsopCodeBlock、DocsNav、部落格中發現硬編碼英文。

sequential設計翻譯計畫
設計翻譯計畫agent

建立 6 步驟計畫:共用 UI 鍵值、元件、頁面、YAML 內容。

sequential建立翻譯命名空間
建立翻譯命名空間mcp

為 en 和 zh-TW 建立 optimize、sop-doc、hub 訊息檔案。

parallel翻譯頁面內容
parallel翻譯 UI 元件
翻譯頁面內容mcp

為首頁、optimize、sop-doc、hub、版面頁尾新增翻譯鍵值。

sequential翻譯 YAML 展示區
翻譯 UI 元件mcp

以 useTranslations 更新 OsopCodeBlock、DocsNav、部落格。

翻譯 YAML 展示區mcp

3 個頁面共 8 個 YAML 區塊現在顯示中文節點名稱。

sequential建構翻譯基礎設施
建構翻譯基礎設施mcp

建立 translate.ts、get-translated.ts 用於執行時 YAML 翻譯。

sequential提取 2126 個字串
提取 2126 個字串cli

從 245 個工作流程提取所有可翻譯字串。

sequential協調 4 個平行翻譯器
協調 4 個平行翻譯器agent

分成 4 個批次並派遣平行翻譯代理。

sequential合併與驗證
合併與驗證cli

合併 245 個工作流程,修復亂碼,驗證所有頁面。

新增你自己的 SOP

為你的 API、團隊、公司撰寫 .osop 檔案。讓每個流程都能被看見、被分享。