gszhangwei/open-spdd

解决的问题

OpenSPDD 解决了"一次性"AI编码提示和模糊的计划文档导致AI即兴发挥、缺乏可追溯性以及设计漂移的问题。它将AI提示转换为可执行的设计契约，确保AI遵循精确的架构模式和编码标准，而不是仅仅生成高层次的任务列表。

工作原理

该项目提供一个跨平台CLI工具，可与各种AI编码环境（如Cursor、Claude Code和GitHub Copilot）集成。它实现了REASONS Canvas，一个7维度的结构化设计框架（需求、实体、方法、结构、操作、规范、保障），用于定义功能的"为什么"、"是什么"和"如何做"。

用户遵循结构化工作流：战略分析 → REASONS Canvas生成 → 代码生成 → 反向同步。CLI工具管理触发这些步骤所需的模板和命令文件，这些步骤在AI工具的原生命令系统中执行。

适用人群

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

主要亮点

• 双向同步：允许用户将代码变更同步回设计文档，保持提示与实现的一致性。
• 跨平台支持：兼容Cursor、Claude Code、GitHub Copilot、Antigravity、OpenCode和Codex。
• 结构化框架：使用REASONS Canvas明确指定方法签名、错误处理和DI模式，而非模糊指令。
• 自动检测：自动识别当前激活的AI编码环境，配置正确的命令目录。