sddw

在 AI 编码助手日益普及的今天，传统的“简短交互式提示”模式在处理复杂项目时往往显得力不从心：上下文丢失、架构决策难以追溯、代码缺乏同行审查机制。sddw (Specification-Driven Development Workflow) 是一个专为 Claude Code 设计的规约驱动开发工作流，旨在通过结构化的文档协作，重塑 AI 辅助编程的工程标准。

核心理念：规约即产物，代码即执行

sddw 颠覆了传统的 AI 交互模式。它不追求通过一次对话生成完美代码，而是引导用户与 AI 代理协作，逐步编写出详尽的规约（Specifications）。

• 文档为中心：规约成为主要产物，可供版本控制、同行审查和跨会话持久化。
• 机械式执行：代码生成不再是基于模糊提示的“创造性飞跃”，而是由已批准规约指导的“机械步骤”。
• 显著成效：研究表明，详细的规约可将 AI 代码错误减少高达 50%，安全缺陷减少 73%，架构不一致的拉取请求减少 60%。

工作流详解：七步闭环

sddw 将开发过程分解为七个离散步骤，每一步只生成一种类型的规约，并在聚焦的上下文窗口中工作，避免信息过载。

1. 📝 需求 (Requirements)：协作生成功能规约，包含用户故事、功能需求和验收标准。
2. 🔍 代码分析 (Code Analysis)：扫描现有代码库，理解模式、接口和约定，确保新代码与整体风格一致。
3. 🏗️ 设计 (Design)：生成跨领域设计文档，明确架构、数据模型及关键技术决策。
4. 📋 任务化 (Tasking)：将功能分解为具体的、引用设计文档的混合任务文件。
5. 💻 实现 (Implementation)：遵循 TDD（测试驱动开发）和提交协议，逐个执行任务。
6. ✅ 验证 (Verification)：对照最初的需求和验收标准，严格验证实现结果。
7. 🔄 自我改进 (Self-Improvement)：分析整个执行过程，提出工作流优化建议，形成闭环。

两种交互模式：掌控与效率的平衡

技术架构：轻量且模块化

sddw 设计极简，无运行时依赖，仅使用 Markdown 文件即可定制和扩展。每个步骤由四个模块化组件组装而成：

• 命令 (commands/)：带有元数据和引用的薄入口点。
• 指令 (instructions/)：定义过程规则——做什么，按什么顺序。
• 问卷 (questionnaires/)：指导对话——如何与用户交互以获取必要信息。
• 规约 (specs/)：输出格式模板——规定最终生成的文档结构。

这种模块化设计使得 sddw 极易定制，团队可以根据自身规范调整指令和模板。

快速开始

1. 安装

git clone https://github.com/sermakarevich/sddw.git ~/.claude/sddw
cd ~/.claude/sddw && bash bin/install.sh

2. 使用

• 启动交互式工作流：在 Claude Code 中直接调用 sddw 命令。
• 启动自动工作流：添加 --auto 标志。
• 查看帮助：使用帮助命令查看工作流概览和功能状态。

对于追求代码质量、注重团队协作和可维护性的开发团队而言，sddw 提供了一套成熟、可审查且高效的 AI 协作范式。它让 AI 不再只是一个代码生成器，而是一个严谨的系统架构师和执行者。