commit-prd

name	commit_prd
description	將 draftPRD 中的文件整併入正式 PRD 資料夾，包含版本歷程管理與智慧合併功能。

提交產品需求 (Commit PRD)

此技能用於將草稿狀態的產品需求文件 (projectDoc/draftPRD) 正式納入專案文件 (projectDoc/PRD)，並自動處理版本歷程。

核心邏輯 (Core Logic)

執行此技能時，請依照下列流程處理指定的草稿文件：

1. 環境準備

• 檢查是否存在 projectDoc/PRD 資料夾，若無則建立。
• 檢查是否存在 projectDoc/draftPRD/history 資料夾，若無則建立。

2. 檔案處理流程

針對指定的 projectDoc/draftPRD 檔案 (例如 1.0_feature.md)：

情境 A：新功能 (New Feature)

條件：PRD 資料夾中 沒有 同名檔案。 動作：

1. 複製：將檔案從 projectDoc/draftPRD 複製到 projectDoc/PRD 資料夾。
2. 封存：將原始檔案從 projectDoc/draftPRD 移動至 projectDoc/draftPRD/history。
3. 重新命名：將移動後的檔案重新命名為 {原檔名}_{YYYYMMDDHHxxxx}.md (時間戳記)。

情境 B：功能更新 (Feature Update)

條件：PRD 資料夾中 已有 同名檔案。 動作：

1. 讀取比對：讀取 projectDoc/draftPRD 中的新版內容與 projectDoc/PRD 中的舊版內容。
2. 智慧判斷：
   • 無衝突 (No Conflict)：
     • 若新內容僅是擴充、新增段落，且與舊內容無邏輯或易用性矛盾。
     • 合併 (Merge)：將新內容整合至 PRD 的檔案中。
     • 標記：若有需要，可微量標記新增區段，但避免影響 AI 閱讀 (例如使用註解或自然段落銜接)。
     • 封存舊草稿：將 projectDoc/draftPRD 中的檔案移至 projectDoc/draftPRD/history 並加上時間戳記。
     • 更新正式檔：用合併後的內容覆蓋 projectDoc/PRD 中的檔案。
   • 有衝突 (Conflict Detected)：
     • 若發現邏輯矛盾、設計方向改變或易用性衝突。
     • 停止自動化：不要自動覆蓋。
     • 通知使用者：使用 notify_user 回報衝突點 (Diff)，請使用者決定：
       1. 直接以新版覆蓋 (Overwrite)。
       2. 放棄本次提交。
       3. 由使用者手動介入修正。

指令範例

當使用者下達「提交 PRD」或 "commit PRD" 時，請先確認使用者要提交哪一份文件，或檢查 projectDoc/draftPRD 下有哪些待提交檔案，並依上述邏輯執行。