OpenSpec 是一个给 AI 编程助手加一层规格说明的工具。它让你和 AI 在动手写代码之前,先把要做什么对齐。
用 AI 写代码,需求只存在聊天记录里。聊到后面上下文一乱,AI 就开始自己发挥:接口字段对不上、功能边界越写越偏,你回头翻聊天记录找当初怎么说的,翻不到。一个功能跨 API 服务、Web 应用和共享库三个仓库时,这种跑偏更明显。
它的做法是把规格单独存起来。每个变更一个文件夹,里面放提案、规格、设计和任务。你直接对 AI 说想做什么,它先读代码、理清方案,把计划写进这个文件夹,代码仓库后面再跟上。比如要给订单接口加一个退款状态,AI 先把涉及哪个仓库、改哪些字段、任务怎么拆写进变更文件夹,你确认完再让它写代码。
它有个 Stores 设计,把规划放在一个独立仓库里。同一个 openspec 目录结构,用 git push 共享。平台团队维护规格,产品团队只读引用,AI 在写代码的地方就能读到。省掉了把需求从 wiki 复制到聊天框这一步,也省掉了 wiki 和代码对不上的麻烦。Stores 目前是 beta。
它支持 30 多个 AI 助手,通过斜杠命令调用。装完初始化就能用,对新手门槛不高。动手前记得备份代码和配置。
如果你感兴趣但不会装,评论区或私信喊我一声。