Docs Site

專案目的

Docs Site 是 SuperPortia 的公開技術文件中心，目標是讓治理框架、操作規則和 API 參考可被外部開發者和協作者查閱。它不是用來展示的，而是用來查的——當有人想了解 SuperPortia 怎麼運作、ADR 怎麼設計、Agent 遵循什麼規則，這裡是第一個查詢點。

設計原則：文件是 SSoT 的鏡像，不是副本。內容從 superportia-ops 自動同步，人工維護零重複。

技術棧

• Docusaurus — 文件網站框架，支援 MDX、版本控制、全文搜尋
• Cloudflare Pages — 部署與 CDN，Git 觸發自動部署
• sync-sources.sh — 自動從 superportia-ops 同步 Rules/Skills/ADRs 至 docs-site
• GitHub Actions（規劃中）— 跨 repo 同步觸發器

核心內容

• ADR（架構決策記錄） — ADR-0001 到 ADR-0010，記錄所有重大架構決策
• Rules（治理規則） — EGS 框架下的行為規則，Agent 必須遵循
• Skills（技能手冊） — Agent 執行特定任務的 SOP
• API 參考 — Cloud UB API、MCP Server 介面文件
• 開發指南 — 環境設定、部署流程、貢獻指南

目前狀態

Active，185 篇文件，17 個分類。sync-sources.sh 已完成 Multi-Repo Migration（ADR-0010）後的適配，可正確從各 repo 自動抓取文件。Cloudflare Pages 部署來源待夏哥更新（HITL 項目）。

與其他專案的關聯

• superportia-ops — Rules/Skills/ADR 的 SSoT 來源，自動同步至此站
• Command Center — Command Center 的 ADR 查閱功能直接讀本地 filesystem；Docs Site 是對外公開版本
• Agentic — 互補定位：Agentic 展示理念與學習；Docs Site 展示技術規格與治理
• EGS（治理框架） — EGS v1.2 的 Rules/Skills 分類結果在此站公開