Refacil SDD-AI：规范驱动开发的AI辅助实践框架

Refacil SDD-AI项目将规范驱动开发（SDD）方法论与AI辅助编程深度融合，通过CLI工具为Claude Code、Cursor、OpenCode等编辑器提供结构化开发工作流，并支持跨仓库代理通信。其核心目标是解决AI生成代码的规范一致性问题，让AI在明确的项目约束下工作，提升开发效率与代码质量。

大语言模型改变软件开发方式，但AI生成代码易出现规范不一致问题，手动提示效率低。SDD-AI由Erikole21发起，核心理念是将项目规范作为AI代理的上下文基础，使AI在约束下工作；借鉴契约式编程与设计先行实践，升级为动态规范系统，规范可被AI实时查询、理解和执行。

1. CLI工具层：以命令行形式交付，提供sdd init（初始化）、sdd spec add（管理规范）、sdd agent run（协调代理）等命令；2. 规范存储系统：通过refacil-sdd/目录存储架构规范、编码标准、领域知识、任务模板，格式兼顾人类维护与AI解析；3. 编辑器集成：为Claude Code（注入规范到上下文）、Cursor（规范查询）、OpenCode（结构化工作流）提供支持；4. 代理通信总线：本地消息总线支持跨仓库代理协作，如后端规范变更推送到前端代理提醒更新。

1. 初始化阶段：sdd init创建规范目录并引导填写项目信息；2. 规范定义：sdd spec命令族添加/修改版本化规范（Markdown+YAML元数据）；3. 开发迭代：创建任务规范，AI代理按理解需求→查阅规范→生成代码→验证合规步骤工作；4. 审查同步：自动检查代码与规范一致性，提醒更新规范或代码。

技术优势：可重现性（相同规范下输出稳定）、知识沉淀（规范成为持久资产）、渐进采用（从单规范逐步扩展）；应用场景：企业级开发（合规与质量控制）、开源项目（降低贡献审查成本）、教育培训（传递工程纪律与架构思维）。

Refacil SDD-AI代表AI辅助编程向结构化、工程化演进的尝试。未来将扩展更多编辑器集成、规范模板库，形成最佳实践社区。其意义在于：在AI能力增强的时代，通过规范驱动让AI在边界内发挥创造力，同时保持人类对关键决策的控制。