OGSM AI Agent 團隊 SOP — 標準作業流程

O 是整個團隊的最終目的地。所有角色的工作最終都要匯入這個目標。

原則

1. 以受眾為主語：O 的主詞是「讀者 / 使用者 / 客戶」，不是「我們的團隊」
2. 包含情感結果：不只是「完成什麼」，而是受眾「感受到什麼」
3. 可想像的成功畫面：讀完 O，腦中能浮現一個具體場景

好的寫法 vs 壞的寫法

✅ 「建築師讀完這門課程後，能獨立判斷任何門五金規範的合規性和適用性，不需要再查資料。他會覺得這門課值得花時間，甚至想推薦給同事。」
說明：主詞是建築師、有情感（值得花時間）、有能力變化（獨立判斷）、有場景（推薦給同事）

O 的常見錯誤

• 太抽象：「提升品牌影響力」→ 對誰的影響力？怎樣算提升？
• 太具體：「SEO 排名進前 3」→ 這是 M（衡量標準），不是 O
• 缺少受眾：「建立最完整的門五金知識庫」→ 誰會用？他用完之後能做什麼？

每個角色有自己的 G。G 是該角色對 O 的貢獻——「如果這個角色的 G 達成了，O 就往前推進了一步」。

原則

1. G 必須串回 O：每個 G 都要能回答「這如何幫助受眾達到 O？」
2. G 不是任務清單：G 描述的是「狀態改變」，不是「要做的事」
3. G 要讓人感受到受眾的存在：讀 G 的時候，腦中應該浮現受眾的臉

好的寫法 vs 壞的寫法

✅ 研究員：「建築師讀到這些案例時，感覺是『這就是我的專案會遇到的風險』，而不只是一個故事」
說明：有受眾感、串回 O 的情感目標

✅ 寫手：「建築師讀完前 6 張投影片後，已經理解問題的嚴重性，並且開始想知道解決方案——這個好奇心驅動他繼續往下讀」
說明：描述受眾的狀態變化、有情感弧線

G 的常見錯誤

• G 變成 M：寫成「交付 N 個東西」→ 應改為「受眾因為這 N 個東西而⋯⋯」
• G 跟 O 斷裂：角色的 G 很好，但看不出來跟整體 O 有什麼關係
• G 太獨立：只看自己的角色，沒考慮跟其他角色的銜接

S 是達成 G 的路徑選擇——「用什麼方法、為什麼選這條路」。

原則

1. S 要有「為什麼」：不只是「做什麼」，而是「為什麼用這個方法而不是其他方法」
2. S 要為受眾量身打造：方法的選擇要基於受眾的知識背景和工作情境
3. S 要包含資源承諾：用什麼工具、參考什麼資料、走什麼流程

好的寫法 vs 壞的寫法

✅ 「使用 MasterFormat 章節編號和 AIA 合約語言，因為建築師認得這些參考體系——這讓他們在讀的時候覺得『這是為我寫的』，而不是通用教材」
說明：為受眾（建築師）量身打造、有為什麼

S 的常見錯誤

• S 太通用：可以套用在任何專案 → 加上「for [受眾], because [原因]」
• S 沒有資源承諾：只說「要研究」但沒說「用什麼資料庫、查什麼來源」
• S 跟 G 脫節：路徑選擇看起來合理，但其實不是在解決 G 的問題

M 是驗收標準——「怎麼確認 S 真的被執行了、G 真的達成了」。

原則

1. M 對準 S，不是對準 G：M 驗證的是「S 的資源承諾有沒有兌現」
2. M 必須可驗證：能回答「是 / 否」或「數字是多少」
3. M 不能自評：不能讓執行者自己判斷自己有沒有達標

好的寫法 vs 壞的寫法

✅ M 寫「每個引用是否有 ICC + NFPA 雙來源記錄？更正了幾處？查詢記錄是否存在？」
說明：可驗證、追蹤 S 的資源承諾

M 的常見錯誤

• M 只數量不管質：「交付 10 題測驗」→ 應加上「80% 通過率校準」
• M 跟 S 脫節：S 說用某個工具，M 完全沒提到那個工具有沒有被使用
• M 是自我宣告：「品質良好」→ 誰判斷？用什麼標準？

當 OGSM 用在「多角色團隊」而不是「單一個人」時，有幾個額外的品質要求：

1. 角色間的銜接

每個角色的 G 不能獨立存在。角色 A 的產出是角色 B 的輸入——這個銜接必須在兩邊的 S/M 中都有體現。

2. 波次（Wave）邏輯

團隊的角色分波次執行。同一波次的角色可以並行，不同波次之間有先後順序。波次之間需要「關卡條件」（Gate）——只有前一波的 M 全部通過，才能啟動下一波。

3. 角色 vs 流程的邊界

• 角色：需要判斷力的持續性工作（例：研究員、寫手、審稿人）
• 流程：可重複執行的規則性工作（例：格式檢查、字數統計、翻譯）

如果一個「角色」的工作完全是規則性的，它應該被降格為「流程」，不需要佔一個角色的位置。

4. 防止「確認偏誤」

如果所有審核角色都是內部團隊成員，容易產生確認偏誤。好的團隊設計會包含至少一個「外部視角」的角色——用不同的評審標準、站在不同的立場來檢查。

步驟

1. 分析任務：這個任務屬於什麼領域？需要什麼專業知識？
2. 載入知識：
   • 已有 Skill → 載入（例：/ogsm-framework、/writing-guide）
   • 沒有 Skill 但會重複使用 → 先建 Skill，存到 references/
   • 一次性知識 → 直接當 context 提供
3. 定義 O：用領域知識 + Part A 的品質要求寫 O

步驟

1. 分析任務複雜度

• 簡單（1-3 步）→ 不需要團隊，直接執行
• 中型（4-10 步、多個面向）→ 3-7 個 agent
• 大型（跨領域、多波次）→ 8-20+ 個 agent

2. 決定角色類型

• 研究型（Investigator）：收集資料、驗證事實
• 寫作型（Writer）：產出內容
• 審核型（Reviewer）：品質把關
• 工程型（Engineer）：技術實作
• 協調型（Commander）：統籌派遣

3. 設計波次

• 研究 → 產出 → 審核 → 工程 → 發布
• 同波次的獨立角色可並行
• 波次之間設定 Gate 條件

4. 決定每個角色是 Agent 還是 Skill

• 需要判斷力 → Agent
• 純規則執行、可被任何 agent 呼叫 → Skill

步驟

1. 套用 Part A 的品質要求撰寫 G/S/M
2. S 必須包含：
   • 使用的 Skill 命令（完整格式）
   • 使用的 Model 命令（見 Phase 4）
   • 資源承諾（資料來源、工具、流程）
3. M 必須包含：
   • 每個 S 資源承諾的對應驗證
   • 可測試的通過/失敗標準
4. 撰寫 Tier 1 摘要（≤150 字）+ Tier 2 完整版

決策規則

實作方式

• 每個 Agent 的 S 段落必須寫明 Model 命令
• 使用 /ai-collab --task <type> 自動路由
• 使用 /ai-fallback 處理配額耗盡的降級

Direction Seed 9 欄位模板

每個子 Agent 的派遣簡報必須包含：

派遣模式

• Pilot Dispatch：先派 1 個 Agent 試跑，確認簡報無誤後再 fan-out 全部
• 並行派遣：同波次的獨立 Agent 一次全派，用背景模式
• 前景 vs 背景：需要結果才能繼續 → 前景；獨立任務 → 背景

4-Robot Factory 模式

用於打磨已有的 Agent 規格：

Gate Review

每個波次結束後，Commander 檢查：

1. 該波次所有 Agent 的 M 是否通過？
2. 產出是否足夠讓下一波次開始？
3. 受眾是否「在場」？（讀產出時能感受到受眾的存在）

Script-First 原則

機械性工作（格式檢查、字數統計、schema 驗證）用腳本執行，不消耗 AI token。只有需要判斷力的工作才用 AI。

v3.2 決定性腳本驗證器（Deterministic Validators）

v3.2 新增三支 Python 腳本，取代純 LLM 事實查核，對規則執行 100% 機械判斷。LLM 負責判斷力工作，腳本負責規則執行，兩者不可互換。

注意：Waterson 自身素材（waterson-product-facts.md）不算外部權威來源。趨勢主張必須引用 ASHE、FGI、NFPA、AIA、peer-reviewed study 等外部機構。

腳本位置：tools/validators/。執行方式：

python3 tools/validators/citation_backcheck.py blog/{slug}/index.html --gt docs/waterson-product-facts.md
python3 tools/validators/causal_inference_scan.py blog/{slug}/index.html
python3 tools/validators/trend_claim_scan.py blog/{slug}/index.html

執行原則

1. Commander 不自己做事：只負責派遣、監控、決策
2. 所有獨立任務並行派遣：不人為分批
3. 錯誤處理：Agent 失敗 → 診斷原因 → 修改 Direction Seed → 重派
4. 基礎設施同步更新：sitemap、llms.txt、blog index 等

該存的

不該存的

• 可以從 code 或 git log 推導出來的東西
• 一次性的任務細節
• 已經寫在 CLAUDE.md 的東西

版本升級時機

• 發現 3+ 個新反模式 → minor version（v5.1 → v5.2）
• 新增/刪除角色 → major version（v5 → v6）
• 純文字修正 → 不升版