動機

決策者 2026-08-03 指示：手刻 HTML 太慢，應該「寫 md → 共用轉換 → 發 Artifact」。

實測代價：FR-060 討論稿手刻 1,003 行，第一支撰寫 agent 因單次輸出過長 stalled mid-stream 陣亡（連檔案都沒開始寫），重派改「分 7 次寫入」才完成，約 11 分鐘。

決策者後續補充三點需求：

1. 要能產出現在 Artifact 上那種樣式（D 項 callout、統計卡、紅框、§ 章節編號）
2. SPEC 站已有機制不動它，討論稿／開發規格走同一套
3. 希望有「一個需求一份主 HTML」，含討論稿／spec／開發過程紀錄／操作手冊／Notion 連結，供未來回查與 release SPEC 站參考

🔴 關鍵現況（2026-08-03 實查，動手前建議複驗）

scripts/deliverables/render_html.py（688 行）已經不只做 SPEC 站了。

它有一段「使用手冊納入機制」（2026-08-01 生效，CM-1028）：build docs/specs/current 時額外納入 docs/user-manual/ 四份白名單手冊（MANUAL_PAGES，在 script 第 97 行），輸出到 current/html/user-manual/，側欄末端加「使用手冊」分組，手冊 md 留在原地不搬家、不隨版本凍結。

這正是要泛化的雛形：md 留在它該在的地方，build 時納入、輸出到站上。現在是白名單硬編，泛化成設定驅動就能涵蓋討論稿與其他文件。

其他事實：

• md 內文轉換交給 pandoc（gfm），script 只負責站台版型與連結改寫
• CSS／JS 已抽成 docs/specs/_shared/site.css 與 site.js（跨版本共用）
• 側欄走 build-time nav-data.json + 瀏覽器端動態渲染
• 產物 html/ 納版控
• 已知限制：站台需 HTTP 開啟（file:// 會被 CORS 擋 nav-data.json 的 fetch）

現況手刻 html 分佈：docs/reference/oscal-v2-field-mapping/ 9 份、FR-056 6 份、FR-037 6 份、FR-058／FR-039 等 5 份（ERD liam 產出物 6 份是工具產出，不算）。

範圍與順序

三件事有依賴，建議 ①② 先做完驗證可用，③ 另開一輪。