跳轉到

Prototype Governance Summary（UI 生成與 SDD 銜接）

文件治理判斷

  • 文件名稱：prototype-governance-summary.md
  • 文件用途：統一 UI 生成、前端規格展開、交付銜接 SDD 的治理總覽與索引
  • 適用對象：PM、SA、PO、前端工程師、AI 協作 Agent
  • 適用範圍：本 repo 內部治理與交付包文件
  • 可見性等級：internal
  • 是否為 SSOT：否（治理導覽與索引；契約 SSOT 仍在各模組 02_Analysis/）
  • 上游依據文件：
  • AGENTS.md
  • internal_docs/workflow/開發文件治理與文件展開_Workflow_SSOT.md
  • internal_docs/文件Metadata_Routing規範.md
  • internal_docs/AI_Skill_Governance規範.md
  • 下游引用文件：
  • docs/governance/naming-rules.md
  • docs/governance/frontend-sdd-operational-readiness.md
  • docs/governance/frontend-sdd-decision-log.md
  • docs/operations/ai-collaboration-workflow.md
  • templates/frontend-sdd/*.md
  • .cursor/skills/frontend-sdd-coach/
  • 待確認事項：
  • 是否以「固定英文檔名 + 中文別名」作為全專案標準
  • 是否針對常用 skill 維護中文啟動關鍵字清單

1) 目標

建立「雛形 → 前端規格 → handoff → SDD 開發」的可複用標準，避免：

  1. 檔名與模板每案不同造成不可搜尋。
  2. UI/Help/Spec 不一致造成工程實作歧義。
  3. API 規劃過晚導致前後端返工。

2) 命名政策（最終採用）

  • 英文檔名固定：作為 repo 主鍵，供搜尋、路由與自動化使用。
  • 允許中文別名：可在文件 frontmatter 或段落 aliases 記錄，提升辨識與啟動效率。
  • AI 中文指令優先：使用者可全中文互動，但產物路徑與模板名稱仍落在固定英文檔名。

結論：採「固定英文檔名 + 可維護中文別名」雙軌，不影響解析判斷。

3) 核心檔名與用途（優先固定）

  1. prototype-governance-summary.md
  2. new-project-prototype-sop.md
  3. naming-rules.md
  4. screen-package-template.md
  5. fields-template.md
  6. actions-template.md
  7. api-map-template.md
  8. acceptance-template.md
  9. field-alignment-gate-template.md
  10. api-planning.md
  11. ui-template-matrix（html 參考範型）

原則：檔名不帶日期版次；版本資訊寫在 YAML/frontmatter 與版本表。

4) 建議流程（前端輔導確認）

  1. Governance 初始化：確認命名規範、文件路由、可見性。
  2. Prototype 盤點：確認畫面區塊、欄位來源、主要 action。
  3. Field Alignment Gate：先做欄位對齊與衝突排除。
  4. Screen Package 展開：輸出欄位、操作、驗收、API map。
  5. UI Hint/Help/Spec 一致化：避免文件與畫面行為不一致。
  6. Frontend Handoff：整理工程可開工結構與待確認清單。
  7. Readiness 檢查：交付前執行 checker/auditor（依場景）。

5) 與 Skill 的映射

  • 既有：document-governor、frontend-requirement-orchestrator（若環境有）
  • 新增：frontend-sdd-coach
  • 用途：把 UI 生成流程轉為可開工的前端規格與 handoff。
  • 產出：欄位模板、畫面規格、交付清單、待裁決清單。
  • 中文啟動：幫我展開畫面交付包／幫我整理前端 handoff／幫我整理驗收條件。