gszhangwei/open-spdd

解决的问题

OpenSPDD 解决了“一次性”AI 编码提示词与缺乏约束、精确度及可追溯性的模糊计划文件问题。它通过将提示词转化为可执行的设计合约，防止 AI 随意发挥或任意重构代码，确保设计与实际实现保持同步。

运作方式

本项目提供一个跨平台的 CLI 工具，实现了 REASONS Canvas，这是一个七维结构化设计框架（Requirements, Entities, Approach, Structure, Operations, Norms, and Safeguards）。

用户遵循特定的工作流程：

1. 分析 (Analysis)：对需求进行策略性分析。
2. 设计 (Design)：生成 REASONS Canvas 设计文档。
3. 生成 (Generation)：将画布作为合约，让 AI 生成精确的代码。
4. 同步 (Sync)：当代码重构或变更时，使用反向同步指令更新设计文档。

适用对象

• 企业开发者：需要设计与实现的可追溯性及长期维护性。
• 开发团队：希望统一 AI 编码标准以减少风格冲突。
• 进行复杂重构的开发者：需要严格的操作顺序以避免依赖混乱。

特色亮点

• 跨平台兼容性：支持 Cursor, Claude Code, GitHub Copilot, Antigravity, OpenCode 以及 Codex。
• 双向同步：允许将代码中的变更同步回设计提示词。
• 结构化框架：以详细的合约取代简单的任务清单，明确规范方法签名、DI 模式与错误处理。
• 自动检测：自动识别 AI 编码环境以应用正确的配置。