OpenSpec:把一次改动变成可验收的变更
结论
OpenSpec 把一次改动落成结构化的 change:提案说明为什么做,规格写清行为契约,设计记录取舍,任务清单驱动实现。和 AI 协作时,它最大的价值不是多写几份文档,而是让「做什么、怎么验收」在写代码前就固定下来。
它解决什么问题
直接让 AI 改代码,需求和实现容易散在对话里:说过的话没有落点,做完也说不清是否达标;上下文一长,早先的约束还会被遗忘。OpenSpec 把变更放进独立目录,先补齐 proposal、specs、design 和 tasks,再按任务实现,最后对照规格验收。规格和任务因此成为跨会话、跨工具都能读取的事实来源。
我的实验
这个站点就是按这套流程推进的。先运行 /opsx:explore 梳理问题和代码库;再用 /opsx:propose 生成 proposal.md、specs/、design.md 和 tasks.md,产物在 openspec/changes/personal-site-foundation/;随后用 /opsx:apply 按任务清单实现,每完成一组就勾掉对应任务。
校验阶段使用 openspec validate personal-site-foundation --strict 对照规格检查,完成后用 /opsx:archive 归档。实际推进中,任务粒度足够细,单次实现范围清楚,很少出现「改到一半发现需求没定义」的情况;仓库目前仍在这个 change 内,尚未归档。
限制
- 前期要维护多份文档,小改动会显得偏重,需要按项目规模裁剪。
- 命令和目录约定较多,国内相关资料和使用者相对少,遇到问题更多要读仓库和规范本身。
- 规格写得含糊,后面的实现和验收同样会含糊;文档质量决定收益。
- 规范不会自动发现需求变化。改了范围却忘记同步 proposal 和 specs,文档就会和代码脱节。
适合谁
需要分阶段推进、多人协作或长期维护的项目,尤其是希望把 AI 开发过程变得可复盘、可验收的人。一次性脚本或纯探索型实验不必上这套流程。