核心用法
SDD开发工作流是一套规范驱动开发（Spec-Driven Development）方法论，通过Claude Code执行/speckit.*命令序列，将自然语言需求转化为可运行的代码。核心流程为：constitution → specify → clarify → plan → tasks → analyze → implement，其中clarify和analyze为强制阶段（至少执行1次）。
使用前需配置ZHIPU_API_KEY（必需），可选GITHUB_TOKEN和ANTHROPIC_API_KEY。通过init-project.sh创建项目后，在Claude Code中以acceptEdits权限模式启动，逐阶段执行开发。支持子Agent模式实现自动化开发，通过sessions_spawn长时间运行。
显著优点
1. 结构化需求管理：将模糊需求转化为精确的规范文档（.spec.md），减少LLM幻觉
2. 迭代可控：自动递增迭代序号（001-xxx, 002-yyy），Git分支隔离，验收后自动创建PR
3. 零注意力依赖：自动安装缺失依赖，检测ModuleNotFoundError时直接执行pip/npm install
4. 断点续传：通过.task-context/目录保存进度，支持长时间运行的Agent恢复上下文
5. 企业级模板：提供constitution-enterprise.md模板，内置代码规范、测试要求、安全准则
潜在缺点与局限性
1. 工具链复杂：需同时掌握Specify CLI（仅初始化）、Claude Code（执行）、以及tmux/sessions_spawn等子Agent机制
2. 成本敏感：依赖GLM-5/Zhipu API，高峰期响应延迟1-5分钟，需设置300秒超时
3. 权限风险高：bypassPermissions模式可自动执行任意bash命令，仅限隔离环境使用
4. 模板依赖：若template_missing或需补充上下文时无法自恢复，必须人工介入
5. 验收标准严格：必须通过py_compile + pytest + 服务启动三重验证，简单原型开发成本较高
适合人群
- 复杂业务系统开发者：需要多轮迭代、严格测试覆盖的企业级应用
- AI-Native开发团队：已采用Claude Code作为主力开发工具，追求"vibe coding"自动化
- 规范驱动方法论践行者：重视需求文档化、架构前置设计的工程团队
常规风险
- Git风险：自动初始化仓库、提交、推送，可能污染现有代码库
- 环境风险：脚本自动执行
apt install等系统级操作 - API密钥泄露：需配置多平台API key，建议仅使用测试令牌
- 无限循环风险：子Agent模式若配置不当可能导致递归调用或资源耗尽