为什么选择 SuperSpec？
AI 辅助开发的挑战
AI 编码助手正在改变软件开发方式，但也带来了新的挑战：
1. 上下文丢失
传统开发：开发者记住项目细节，多次会话保持连贯
AI 辅助：每次会话重新开始，AI 不记得之前的决策结果：重复解释需求、不一致的代码风格、遗忘的设计决策
2. 需求模糊
用户："帮我加个登录功能"
AI：可能产出几十种不同的实现方式结果：返工、代码质量参差不齐、难以维护
3. 缺乏文档
传统开发：先写设计文档，后写代码
AI 辅助：直接生成代码，跳过设计阶段结果：技术债务快速积累、新人难以理解代码、维护成本高
SuperSpec 的解决方案
规格先行
需求 → 规格文档 → 任务清单 → 代码实现 → 归档每个功能都有完整的规格文档，包括：
- 用户故事和验收标准
- 功能需求和技术设计
- 任务分解和进度追踪
上下文经济
| 约束 | 原因 |
|---|---|
| 每个文件 ≤ 300 行 | 适配 AI 上下文窗口 |
| 单一职责 | 便于定位和修改 |
| 结构化格式 | AI 更容易解析 |
双模式工作流
| 模式 | 产物 | 适用场景 |
|---|---|---|
| 标准模式 | proposal + tasks | 简单功能、Bug 修复 |
| 增强模式 | + spec（支持拆分子 spec ）+ design + checklist | 复杂功能、需要评审 |
上下文恢复
bash
# 会话结束前
superspec sync # 保存当前状态
# 新会话开始
/ss-resume # 恢复上下文效果：跨会话保持上下文，AI 可以继续之前的工作
核心价值
对开发者
- 减少返工 - 先规格后代码，避免方向错误
- 提高效率 - 结构化流程，减少沟通成本
- 质量保障 - 内置检查清单和验证机制
对团队
- 知识沉淀 - 每个功能都有完整文档
- 协作便利 - 统一的工作流程和产物格式
- 可追溯性 - 从需求到代码的完整链路
对项目
- 减少技术债 - 规格驱动，文档同步更新
- 降低维护成本 - 清晰的历史记录
- 易于交接 - 新人可快速了解项目演变