Prompt file imported from Zenobia000/cursor-agentic-coding-template (
.cursor/commands/implement.md). Copyright stays with the author.
💻 IMPLEMENT MODE (v3)
將設計藍圖轉化為功能齊全、經過測試、且高品質的程式碼。
1. PLAN 🎯 (規劃)
Objective
根據
tasks.md中指定的任務和其關聯的creative-*.md設計文檔,以測試驅動開發 (TDD) 的方式,編寫產品程式碼和對應的測試,並持續更新memory-bank/current/progress.md來記錄進度。
Guiding Rules
在執行此指令時,AI Agent 必須遵循以下規則:
- 主要規則:
.cursor/rules/principles/global.mdc - 測試優先:
.cursor/rules/testing/overview.mdc - 程式碼品質:
.cursor/rules/backend/overview.mdc或.cursor/rules/frontend/overview.mdc - 指令執行:
.cursor/rules/isolation_rules/Core/command-execution.mdc - 核心隔離:
.cursor/rules/isolation_rules/main.mdc
Prerequisites Check
在開始編碼之前,請確保:
- ✅ 任務已設計:
memory-bank/current/tasks.md中的當前任務已關聯一個或多個creative-*.md設計文檔。 - ✅ 設計已批准: 相關的設計文檔已被用戶確認。
- ❌ Failure Action: 如果找不到對應的設計文檔,AI 必須拒絕編碼,並建議用戶先執行
/creative來完成技術設計。
2. DO 実行 (執行)
Core Process
遵循一個嚴格的、包含健康檢查的測試驅動開發循環:
Step 0: 健康檢查 (Health Check)
- 檢查設計完整性: 讀取
tasks.md所連結的creative-*.md文件。驗證設計文檔是否清晰、完整。 - 批判性思考: 如果設計文檔含糊不清 (e.g., "然後處理數據"),AI 必須要求更具體的設計細節。
Step 1: 記憶體互動 - 讀取 (Memory Interaction - Read)
- 讀取任務與設計: 從
memory-bank/current/tasks.md讀取任務要求,從關聯的creative-*.md讀取詳細的技術設計。
Step 2: 迭代開發 (Iterative Development)
- 遵循 TDD:
- 寫一個失敗的測試 (Red): 根據設計,為即將實現的最小功能單元編寫一個測試,並確認它因功能未實現而失敗。
- 寫最少的程式碼讓測試通過 (Green): 編寫最簡潔的產品程式碼,恰好能讓該測試通過。
- 重構 (Refactor): 在測試保護下,優化剛才編寫的程式碼。
- 重複此循環,直到任務的所有功能點都已實現。
Step 3: 記憶體互動 - 寫入與更新 (Memory Interaction - Write & Update)
- 寫入產品程式碼: 在專案的源碼目錄中創建或修改對應的檔案。
- 寫入測試程式碼: 在專案的測試目錄中創建或修改對應的測試檔案。
- 持續更新進度: 在每個重要的開發節點,更新
memory-bank/current/progress.md文件,簡要說明進度。
3. CHECK ✓ (檢查)
Verification Checklist
- 功能符合設計: 實作的功能是否完全符合
creative-*.md中的設計? - 測試全部通過: 所有相關的測試是否都已通過?
- 記憶體同步:
memory-bank/current/progress.md是否已更新?
4. ACT 改善 (行動)
Finalization
- 向用戶報告: 在一個主要功能的實作完成後,向用戶報告。例如:「任務『用戶登入』已完成,包含完整的程式碼和 95% 的測試覆蓋率。」
Next Steps
完成一個實作任務後,繼續推進專案。
- 👉 Primary Next Step: 執行
/task-next,讓 PM 小助理建議下一個最高優先級的任務。 - 💡 Alternative: 如果所有任務都已完成,請執行
/reflect指令,對整個實作階段進行一次全面的回顧。
IMPLEMENT MODE (v3) 已啟動。正在檢查
current工作區的設計文檔,準備開始 TDD 循環...
