gszhangwei/open-spdd

解決的問題

OpenSPDD 解決了「一次性」AI程式提示與模糊的計畫文件所導致的AI即興發揮、缺乏可追蹤性以及設計偏移的問題。它將AI提示轉換為可執行的設計契約，確保AI遵循精確的架構模式與程式撰寫標準，而非僅僅產生高階的任務清單。

工作原理

本專案提供一個跨平台的 CLI 工具，可與各種 AI 程式環境（如 Cursor、Claude Code 和 GitHub Copilot）整合。它實作了 REASONS Canvas，一個七維度的結構化設計框架（需求、實體、方法、結構、操作、規範、保障），用以定義功能的「為什麼」、「是什麼」與「如何做」。

使用者遵循結構化工作流程：戰略分析 → REASONS Canvas 生成 → 程式碼產生 → 反向同步。CLI 工具管理觸發這些步驟所需的範本與命令檔案，這些步驟在 AI 工具的原生命令系統中執行。

適用對象

• 企業開發者：需要設計與實作可追蹤性以及長期可維護性的開發者。
• 開發團隊：希望統一 AI 程式標準以減少風格衝突的團隊。
• 架構師：進行複雜重構時，需要嚴格操作順序以防止依賴混亂的架構師。

主要亮點

• 雙向同步：允許使用者將程式碼變更同步回設計文件，保持提示與實作的一致性。
• 跨平台支援：相容 Cursor、Claude Code、GitHub Copilot、Antigravity、OpenCode 和 Codex。
• 結構化框架：使用 REASONS Canvas 明確指定方法簽章、錯誤處理與 DI 模式，而非模糊指令。
• 自動偵測：自動識別目前激活的 AI 程式環境，配置正確的命令目錄。