Skip to content

OpenSpec最佳实践

实现一个贪吃蛇的游戏,演示从项目初始化到创建第一个提案的过程

1.初始化一个前端工程,模版来自vitejs官网

bash
$ pnpm create vite my-game --template vue

2.用vs code打开生成的项目,在终端中执行openspec初始化

openspec初次使用请看文档OpenSpec新手入门教程

bash
$ openspec init

3.(可选)在AI编程工具(Copilot)中输入openspec推荐的初始化project.md提示词

Please read openspec/project.md and help me fill it out
    with details about my project, tech stack, and conventions

4.在AI编程工具(Copilot)中创建提案

bash
> /openspec-proposal 实现一个10*10大小的贪吃蛇游戏
change-id add-snake-game

5.提案确认没有问题,AI编码

bash
> /openspec-apply add-snake-game

6.测试没有问题,归档改动

bash
> /openspec-archive add-snake-game

使用误区

所有的变更都走openspec

Spec驱动不是帮你解决”业务/逻辑/算法"难题

它不是解决难题,是建立规范,产生文档,记录变更

有了 Spec文档,rules 还有用吗?

上下文大小处理有区别,规范不会被压缩,rules会被压缩

有了spec之后token消费增加了,还值得吗

  • 已经很好的编写技术流程文档,可以不用
  • 提示词已经能够写的很好了(简单任务不要用)
  • 复杂任务推荐用(降低和LLM的反复对话,提高准确率 => 降低编码成本)
最近更新