SKILL.md
提交產品需求 (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 資料夾中 沒有 同名檔案。 動作:
- 複製:將檔案從
projectDoc/draftPRD複製到projectDoc/PRD資料夾。 - 封存:將原始檔案從
projectDoc/draftPRD移動至projectDoc/draftPRD/history。 - 重新命名:將移動後的檔案重新命名為
{原檔名}_{YYYYMMDDHHxxxx}.md(時間戳記)。
情境 B:功能更新 (Feature Update)
條件:PRD 資料夾中 已有 同名檔案。 動作:
- 讀取比對:讀取
projectDoc/draftPRD中的新版內容與projectDoc/PRD中的舊版內容。 - 智慧判斷:
無衝突 (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 下有哪些待提交檔案,並依上述邏輯執行。