📋 PT-MT Workflow Hub AGENT ENTRY POINT v3.0

所有 SSOT、Template、Harness 的唯一可視化入口。Agent 開始任何任務前，必須從本檔開始。
檔名前綴數字 = 執行順序 (01~12)。你看到的 = Agent 執行的（symlink 架構，一個真相）。

🚨 Agent 強制進場規則（每次任務開始前必讀）

  1. 讀取本頁面 (01_SSOT_ENTRY_POINT_workflow_hub.html)。
  2. 根據任務類型選擇流程（見下方「新文章」或「修改文章」流程）。
  3. 所有新文章必須從 08_Article_Template.html 生成，禁止從零手寫。
  4. 圖片與 DOM 規範強制對齊 Knee 標竿：所有圖片必須用 <div class="msa-visual-grid"> 包覆、圖片具備 width="1376" height="768" 與 msa-responsive-img；正文禁止使用 ad-hoc Tailwind 類名，必須採用 .msa-analogy-box (比喻卡)、.msa-formula 與 .mermaid-container。
  5. 任何修改完成後，執行 11_HARNESS 與 Python 自動化工具鏈。
  6. Harness 全部通過才算任務完成，禁止在有 FAIL 的狀態下宣告完成。
⭐ PT-MT 臨床專題雙軌知識庫 PORTAL 快速入口 (AUTHOR PORTALS SSOT)
👨‍⚕️ 蔡俊逸 獨立原創 (80篇) ＋ 🤝 蔡俊逸 × 何秉勳 共著 (100篇) ＝ 全站 180 篇臨床實證文章
🆕 流程 A — 撰寫新文章 完整流程
01 進場 → 02 策略 → 03 SSOT → 04 寫作規範 → 05 語氣指南 → 06 比喻寫作 → 07 排版規範 → 08 生成文章 → 09 圖片協議 → 10 圖片規格 → 11 Harness ✓
✏️ 流程 B — 修改現有文章 快速流程
01 進場 → 03 SSOT → 04 寫作規範 → 07 排版規範（如改圖） → Surgical Patch → 11 Harness ✓

修改文章時只讀必要的 protocol，跳過不相關步驟。但 Harness Gate 絕對不可跳過。

⚡ Agent 自動化工具鏈與觸發時機矩陣 (TOOL EXECUTION TIMING MATRIX)

Agent 在不同寫作/修復階段，必須依據以下時機點呼叫對應的 Python 自動化腳本：

階段 1：改完 H2/H3 後 ➔ 提取圖片 Spec (generate_heading_image_specs.py)
# 觸發時機：完成 H2/H3 標題與內文撰寫，準備產圖時
uv run --with beautifulsoup4 python C:/Dev/pt-mt/tools/generate_heading_image_specs.py --file <html_path>
階段 2：圖片產出後 ➔ DOM 圖文注入 + JSON-LD (auto_inject_dom_images.py)
# 觸發時機：WebP 圖片已存入 assets/，準備精確插入 H2/H3 DOM 與寫入 ImageObject
uv run --with beautifulsoup4 python C:/Dev/pt-mt/tools/auto_inject_dom_images.py --file <html_path>
階段 3：文章存檔後 ➔ Post-Harness 格式修復 (auto_fix_clinical_articles.py)
# 觸發時機：文章改完儲存，自動校正表格 two-cols/three-cols、References 與 JSON-LD 日期
uv run --with beautifulsoup4 python C:/Dev/pt-mt/tools/auto_fix_clinical_articles.py --file <html_path>
階段 4：宣告完成前 ➔ 終極 SSOT 驗證 (validate_clinical_articles.py)
# 觸發時機：提交前強制 Gate 驗證，全數通過才可宣告完成
python C:/Dev/pt-mt/tools/validate_clinical_articles.py --series <series_name>
🛡️ Step 11 — Harness Gate 每次修改後必執行
執行命令（改哪個系列 → 驗哪個系列）
python C:/Dev/pt-mt/tools/validate_clinical_articles.py --series <series_name>

# 範例
python C:/Dev/pt-mt/tools/validate_clinical_articles.py --series knee
python C:/Dev/pt-mt/tools/validate_clinical_articles.py --series mcl_series
python C:/Dev/pt-mt/tools/validate_clinical_articles.py --series shoulder_impingement_series

# 只驗單一文章
python C:/Dev/pt-mt/tools/validate_clinical_articles.py --file B01_Exercise_WhyMove.html

通過條件：🎉 所有文章符合 SSOT 規範 — 未通過前不得宣告任務完成。

🔄 流程 C — 修復舊文章 (Remaster) 特殊流程
📁 其他 Templates
🧠 Skills — 複雜任務時載入
📚 參考文件 非流程必讀