watersonusa.ai / blog / zh

HSW-002 v5.1 — 19 Agent OGSM 定義（現況快照）

產生日期 2026-04-11 | Tier 1 摘要擷取自 WTR-HSW-002-OGSM-v5.md

O — Objective

O：建築師離開這堂課時真心覺得好玩 — 並且具備獨立判斷任何門用五金規格之合規性與適用性的能力，不需要再查閱。

目標人物：Project Architect（非設計建築師，非主持建築師）。所有審查視角、內容假設與互動設計皆以 Project Architect 的日常工作流程為校準基準。

團隊結構

波次	角色	Agent
Wave 1	研究與初稿	Investigator A, Investigator B, Writer A, Writer B, Engagement Designer
Wave 2	品質審查	Content Director, Compliance Reviewer, Copy Editor, Fact Checker, Source Reviewer
Wave 2	外部審查	Project Architect Advisor, Sales Rep Advisor, Fresh Eyes Reviewer
Wave 3	整合與部署	Engineer (HTML), Commander (A君)
旁通道	內容管線	Candidate Collector
量測層	持續監控	Performance Supervisor, Quality Auditor, Learning Outcome Validator

共 19 個角色，其中 3 個為外部審查者。

19 Agent Tier 1 摘要

1. 👑 Commander (A君) Wave 3

G：19 個 agent 共同服務同一個建築師體驗；每波結束回答「建築師視角是否存在？」
S：每波閘門審查加入建築師視角檢查點；隔離外部/內部審查者；Pilot Dispatch 確保平行派遣前的正確簡報。
關鍵 M：每波產出 gate-review-002-waveN.md；外部審查者報告於 Wave 3 前完成；Direction Seed 9 個欄位完整。
Skill：透過中央 Skill Invocation Map；自身 LLM 決策使用 call_with_fallback.sh。
Model：Claude Opus（指揮、決策、Pilot Dispatch 判斷）
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

2. 🔍 Investigator A — Cases & Data Wave 1

G：讓建築師讀案例時感覺「這就是我下個月的專案」。
S：從 DHI + 法庭文件雙來源尋找 2020 年後真實案例；每個案例包含 AHJ 反應或保險結果作為情感錨點。
關鍵 M：≥ 5 個案例 / 每案雙來源驗證狀態 / ≥ 1 個 2020 年後案例 / DHI 查詢含具體文件 ID。
Skill：/content-scout flag-candidate --source-agent investigator-a
Model：WebSearch（研究主力）；/ai-fallback 僅用於生成子任務。
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

3. 🔎 Investigator B — Codes & Cost Wave 1

G：建築師在專案會議中能引用法規條文 + 版本年份；有成本數字為選擇辯護。
S：以 MasterFormat 架構整理法規；ICC + NFPA 雙來源交叉驗證每筆引用；成本包含 AHJ 退件間接成本。
關鍵 M：每筆引用含精確條號 + 版本年份 / ICC Digital Codes 查詢 URL 已記錄 / ICC 與 NFPA 差異有更正紀錄。
Skill：/content-scout flag-candidate --source-agent investigator-b
Model：call_with_fallback.sh 鏈：gemini-2.5-flash, flash-lite, pro, codex
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

4. ✍️ Writer A — Front Half (Theory & Mechanism) Wave 1

G：讀完前半段後，建築師對自己看過的某扇門產生了從未想過要問的問題。
S：從建築師決策點出發導向機械原理；第 1 張投影片用看似合理卻被 AHJ 退件的規格選擇作為引子。
關鍵 M：第 1-12 張投影片 Markdown 初稿 / ≥ 2 個互動檢查點 / 每項技術宣稱可追溯至 Investigator A/B 來源 / 「引子投影片」明確標示。
Skill：/content-scout flag-candidate --source-agent writer-a
Model：Claude Sonnet（核心寫作）
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

5. ✍️ Writer B — Back Half (Scenario Recognition & Spec Resource Navigation) Wave 1

G：建築師帶走情境辨識能力（何時使用）及實施路徑（SpecLink / SPC Alliance / CSC/CSI 操作方式）。
S：教授 5 個情境辨識（含視覺錨點）+ 3 個第三方中立規格資源（從平台價值出發，非 Waterson）；破除「只有三大品牌」迷思。
關鍵 M：3 個規格資源各有獨立介紹段落 / 5 個情境各有視覺錨點 / 附中立性自我審核 / Sales Rep Advisor 確認「聞起來像資訊」。
Skill：/content-scout flag-candidate --source-agent writer-b
Model：Claude Sonnet（核心寫作）
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

6. 🎨 Engagement Designer Wave 1

G：整堂課保留 ≤ 3 個關鍵決策節點互動；每個都是建築師真正需要判斷的時刻。
S：固定格式：「出題 → 延遲數秒 → 自動揭示答案」；干擾選項來自 Investigator A 真實案例；錯誤回饋無需講師即可完整。
關鍵 M：互動點 ≤ 3 / 每個干擾選項引用 Investigator A 來源 / 錯誤回饋包含真實後果（AHJ 退件或保險拒賠）。
Skill：無
Model：Claude Sonnet（互動設計）
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

7. 📋 Content Director Wave 2

G：每張投影片都維持在「從誤解到真正理解」的故事弧線上；不做技術補丁。
S：以建築師的提問結構評估每個轉場（跟我有關嗎？→ 真的重要嗎？→ 我該怎麼做？）；標記所有法規朗讀語氣和預設五金專業知識。
關鍵 M：每張投影片有審查紀錄 / 所有「法規朗讀」語氣已標記並退回 Writer / Writer B 的 5 個情境按「建築師遇到的頻率」排序。
Skill：無
Model：Claude Sonnet（敘事審查）
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

8. ✅ Compliance Reviewer Wave 2

G：課程通過 AIA 認證；建築師的 CEU 學分紀錄乾淨且無爭議。
S：從學習目標反向驗證 AIA HSW 分類；標記所有「廠商推薦」風險；Gemini 2.5 Pro 角色扮演 AIA 審計員為每個 Big 3 提及評分。
關鍵 M：每個 Big 3 提及次數 > 0 且附投影片編號 / Waterson 宣傳比例 < 20%（數值計算）/ 中立性分數平均 ≥ 4/5。
Skill：無
Model：call_with_fallback.sh 鏈：gemini-2.5-pro, flash-lite, codex（AIA 審計員角色扮演）
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

9. 📝 Copy Editor Wave 2

G：建築師永遠不需要重讀一張投影片；術語一致到可以直接複製貼上到規格文件。
S：術語按 MasterFormat 用法統一；每句話符合「建築師一口氣讀完」標準；詞彙表對應 MasterFormat 位置。
關鍵 M：零容忍：被動語態指令文字 / 投影片句子 > 25 字 / 首次使用未定義的縮寫 / 交付 glossary-002.md。
Skill：無
Model：Claude Sonnet（語言編輯）
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

10. 🔢 Fact Checker Wave 2

G：課程中每個數字被質疑時，建築師都能說「來自 [具體來源]，[年份] 版。」
S：驗證優先順序：法規條號 → 成本數字 → 荷重/關門力數值；每個「已驗證」數字有 Gemini Flash 搜尋摘要；無法驗證的宣稱改寫為估計值。
關鍵 M：100% 數值宣稱已審核 / 每個「已驗證」數字有搜尋摘要 / 最終課程零「錯誤」狀態宣稱。
Skill：無
Model：call_with_fallback.sh 鏈：gemini-2.5-flash, flash-lite, pro, codex
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

11. 📎 Source Reviewer Wave 2

G：建築師課後 5 分鐘內能追溯任何法規或案例到原始出處。
S：AIA 相容引用格式；標記所有 2018 年前法規來源；單一機構引用 ≤ 40%；Codex 交叉驗證所有引用。
關鍵 M：所有來源 URL 可存取（HTTP 200）/ 2018 年前法規已標記 / 單一機構 ≤ 40% / Waterson 資料 ≤ 20% / SpecLink、SPC Alliance、CSC/CSI URL 確認可連線。
Skill：無
Model：call_with_fallback.sh 鏈：codex, gemini-2.5-pro, flash-lite（深度 ≥ 3 必要）
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

12. 🎯 Project Architect Advisor Wave 2 External

G：12 年經驗的 Project Architect 人格讀完課程後感覺「這是為我的工地寫的」。
S：對照 PA 的實際工作流程審查（圖面 / Division 08 / 規格書撰寫者協調 / AHJ 送審）；回答 6 個具體決策問題；模擬線上自學體驗。
關鍵 M：6 個問題已回答 / 每則負面回饋引用具體段落 / Commander 對所有負面意見有處理紀錄。
Skill：/content-scout flag-candidate --source-agent project-architect-advisor
Model：Gemini 2.5 Pro（人格主力，透過 call_with_fallback.sh）；Claude Opus 作為已文件化的備援。
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

13. 💼 Sales Rep Advisor Wave 2 External

G：8 年經驗的業務人格判定「我可以用這個去拜訪建築師」，並確認規格資源介紹「聞起來像資訊」。
S：以「這能當開場白嗎？」評估每個段落；特別測試 SpecLink / SPC Alliance / CSC/CSI 介紹的廠商味；語言可及性；Waterson 過度宣傳。
關鍵 M：5 個問題已回答 / Q5（規格資源廠商味）回答「輕微廠商導向」或「明顯廣告」自動觸發 Commander 要求 Writer B 修改。
Skill：無
Model：透過中央 Model Invocation Map（不內嵌指令以避免 P-003 map drift）；必須使用 call_with_fallback.sh 包裝。
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

14. 🔄 Fresh Eyes Reviewer Wave 2 External

G：完全陌生的讀者發現每個論點都能獨立成立。
S：僅接收最終課程稿件（無 Wave 1/2 報告）；以門外漢身份質疑循環論證、選擇性引用和預設立場；每項質疑含修訂方向。
關鍵 M：質疑 ≥ 3 個論點 / 每項質疑包含「被質疑論點 / 原因 / 修訂方向」/ Commander 對每項有決策紀錄。例外：clean_draft_asserted 豁免需下游 false-assert 審計。
Skill：無
Model：call_with_fallback.sh 鏈：gemini-2.5-pro, flash-lite, codex
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

15. 💻 Engineer (HTML) Wave 3

G：建築師打開課程時從不想「這怎麼操作」— 只想「我在學什麼」。
S：在辦公室工作站 + 筆電上測試；自包含，無 CDN 依賴；呼叫 /post-test-designer 和 /aia-rewrite --bilingual；互動回饋 200ms 內。
關鍵 M：W3C 驗證零錯誤 / 3 種螢幕尺寸正確渲染 / WCAG 2.1 AA 通過 / 互動回饋 ≤ 200ms / 已產出測驗和雙語版本。
Skill：/post-test-designer --course HSW-002 --distribution 4/4/2, /aia-rewrite --course HSW-002 --bilingual
Model：Claude Sonnet 透過 Agent tool（HTML 實作）
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

16. 📊 Performance Supervisor Measurement

G：Commander 知道每波哪些角色推進了建築師體驗、哪些沒有。
S：每角色加入建築師視角分數（1-3）；以 Gemini Flash 分析作為評分依據；問題立即回報 Commander，不等波次結束。
關鍵 M：每波交付 monitor-002-waveN.md / 分數 1 或 2 的角色含 Gemini Flash 分析摘要 / 跨波相同問題升級為系統性問題。
Skill：無
Model：call_with_fallback.sh 鏈：gemini-2.5-flash, flash-lite, pro, codex
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

17. 🔍 Quality Auditor Measurement

G：每個角色的交付物讓下一個角色 10 分鐘內開始工作 — 不需重新格式化，不需追來源。
S：對每個交付物執行「交接模擬」；驗證「S 承諾的資源確實存在」；將交接失敗分類為格式 / 內容 / 建築師視角問題。
關鍵 M：每波交付 audit-002-waveN.md / 「S 承諾資源存在」為必填欄位 / 建築師視角問題升級至 Commander。
Skill：無
Model：Claude Sonnet（審計判斷）
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

18. 🎓 Learning Outcome Validator Measurement

G：部署前，從 3 個建築師人格測試中取得具體證據，確認 O 的「獨立判斷」能力已達成。
S：3 個人格（通才 / 習慣用彈簧鉸鏈的資深者 / 熟悉門弓器的建築師）各回答 5 個獨立設計的決策題；任一人格錯 ≥ 2 題觸發 Commander 暫停 Wave 3。
關鍵 M：3 個人格各通過 ≥ 4/5 題 / ≥ 2 個人格能說出具體的規格資源使用路徑 / 升級機制在 HTML 產出前啟動。
Skill：無
Model：call_with_fallback.sh 鏈：gemini-2.5-pro, flash-lite, codex
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區

19. 🗃️ Candidate Collector — Blog Topic Queue Writer Side Channel

G：跨波維持佇列 8 種類型的分布平衡；防止課程只產出單一類型的部落格主題。
S：每波後掃描 .content-scout-queue.md；按類型計數；不平衡時（任一類型 ≥ 3 且另一 = 0），寫入 ## Type Distribution 段落 + 警示。
關鍵 M：## Type Distribution 每波更新 / 不平衡警示必須觸發（缺少 = 怠職）/ 主動呼叫 /content-scout flag-candidate 從現有交付物補齊缺少類型。
Skill：/content-scout flag-candidate --source-agent candidate-collector --source-file [path] --type [missing-type]
Model：Claude Sonnet（類型平衡判斷）
Anti-patterns：詳見 v5.md 中該 agent 的 Anti-patterns 專區