在已有项目里使用 AI,最大风险通常不是写不出来,而是改得太多、影响太广。OpenSpec 的价值,就是在每次协作前先把变更范围说清楚,让 AI 在明确边界内工作。
核心理念先限定范围,再开始改动
避免 AI 在复杂项目里到处联想、顺手改一片。
适用场景已有系统功能迭代和修复
尤其适合需要稳妥修改、不能大范围重构的项目。
主要价值减少误改和扩散风险
让每次协作都更像一次受控修改,而不是模糊探索。
核心理念
OpenSpec 的本质不是多一份文档,而是让“这次允许改什么、不允许碰什么”在动手前就变得明确。
- 每次改动都应有清晰范围。
- 把允许修改的模块、目标和边界讲清楚。
- 减少 AI 因上下文不完整导致的误改。
使用场景
它最适合用于已经在线、已有复杂逻辑、需要稳定演进的项目。
- 已有项目的功能迭代。
- 老系统中的 Bug 修复。
- 对影响范围敏感的局部优化。
工作流程
1. 定义变更范围
明确本次只处理什么问题,涉及哪些模块。
2. 编写 OpenSpec
把边界、约束、目标和验收条件写清楚。
3. AI 生成代码
让 AI 基于受控输入执行修改,而不是自由发挥。
4. 验证影响范围
检查改动是否仍然停留在预期边界内。