SOP Doc：瀏覽與理解任何工作流程

osop_version: "1.0"
id: "osop-sop-doc-browse"
name:"SOP Doc：瀏覽與理解任何工作流程"
description:"SOP Doc 的運作方式：撰寫 .osop 檔案、視覺化瀏覽、與任何人分享。非工程師也能閱讀視覺化分頁。"
tags: [osop, sop-doc, meta, browse]

nodes:
  - id: "write_osop"
    type: "human"
    name: "撰寫 .osop 檔案"
    description: "以 YAML 定義流程，每個步驟為一個節點（api、agent、human、cli、cicd），連接為邊（sequential、conditional、fallback、loop）。"

  - id: "validate"
    type: "cli"
    name: "osop validate"
    description: "依據 JSON Schema 檢查 .osop 檔案，在任何人看到之前提前發現錯誤。"
    runtime:
      command: "osop validate workflow.osop.yaml"

  - id: "visual_browse"
    type: "mcp"
    name: "在 SOP Doc 中瀏覽"
    description: "開啟 osop.ai/sop-doc，每個工作流程顯示兩個分頁：視覺化（含彩色節點的流程圖）與 .osop（完整 YAML）。支援搜尋與來源篩選。"

  - id: "open_editor"
    type: "mcp"
    name: "在視覺化編輯器中開啟"
    description: "點擊「在編輯器中開啟」即可看到互動式節點圖表，可拖曳節點。提供 5 種檢視模式：graph、story、role、agent、code，並內建風險分析。"

  - id: "share"
    type: "human"
    name: "與團隊分享"
    description: "複製 YAML 或傳送編輯器連結。PM 閱讀視覺化分頁，工程師閱讀 YAML，所有人看到相同的流程。"

edges:
  - from: "write_osop"
    to: "validate"
    mode: "sequential"
  - from: "validate"
    to: "visual_browse"
    mode: "sequential"
  - from: "visual_browse"
    to: "open_editor"
    mode: "sequential"
  - from: "open_editor"
    to: "share"
    mode: "sequential"
  - from: "validate"
    to: "write_osop"
    mode: "fallback"