AI编程 - OpenCode+OpenSpec 实战：AI 编程完整演示教程

前言

如果您觉得有用的话，记得给博主点个赞，评论，收藏一键三连啊，写作不易啊^ _ ^。
而且听说点赞的人每天的运气都不会太差，实在白嫖的话，那欢迎常来啊!!!

AI编程 - OpenCode+OpenSpec 实战：AI 编程完整演示教程

1. OpenCode

OpenCode 是一款开源 AI 编程助手 / AI 代码编辑器 ，基于 VS Code 内核开发，支持桌面客户端、终端 TUI、IDE 插件三种使用形态，能对接 Claude、GPT、本地大模型等 75 + 种 AI 模型。

地址: https://github.com/anomalyco/opencode
桌面下载:

2. OpenSpec

OpenSpec 它是 npm 包，装好后 openspec init，然后用 /opsx:propose、/opsx:apply、/opsx:archive 这些命令推进。
最大的优点是它不会把一个小需求弄成大工程，你要改一个功能，它就帮你把这次改动说清楚：为什么改，改什么，任务怎么拆，做完怎么归档。
这对老项目特别有用，很多时候我们不是从零做产品，只是在一个已经跑起来的仓库里加功能。以前这些东西都躺在聊天记录里，过两天就找不到了，OpenSpec 可以把它放回项目里。

官网:https://openspec.dev/

github代码:
https://github.com/Fission-AI/OpenSpec

使用说明:

你输入指令：/opsx:explore AI 回复：你想要调研开发哪块功能？ 你：我想做深色模式，但不清楚怎么写一套整洁规范的实现方案。 AI：我先梳理下你的样式架构…… 最优简洁方案：CSS 变量搭配轻量主题上下文， 同时自动读取系统明暗偏好，无需引入第三方依赖。需要细化方案范围吗？ 你：好，细化一下。 你输入指令：/opsx:propose add-dark-mode AI：已创建文档目录 openspec/changes/add-dark-mode/ ✅ proposal.md — 开发动因、本次改动说明 ✅ specs/ — 功能需求与交互场景文档 ✅ design.md — 技术实现方案设计 ✅ tasks.md — 开发落地任务清单 方案文档全部就绪，可开始开发！ 你输入指令：/opsx:apply AI：开始执行开发任务…… ✅1.1新增主题全局上下文容器 ✅1.2编写明暗切换按钮组件 ✅2.1定义全套主题 CSS 变量 ✅2.2对接本地存储 localStorage 持久化主题设置 全部开发任务已完成！ 你输入指令：/opsx:archive AI：已归档至 openspec/changes/archive/2025-01-23-add-dark-mode/ 全局功能规范文档同步更新完毕，可开启下一个新功能需求。

3. 配置初始化

3.1. 安装OpenSpec。

npminstall-g@fission-ai/openspec@latest

查看版本号:

openspec--version

3.2. 初始化

在项目文件夹下进行初始化。

openspec init

回车。

这里我使用OpenCode进行测试，所以选择OpenCode。

回车。

可以在项目根目录下，看到下面两个文件夹。

4. AI 编程完整演示

实现功能:

功能:做一个分布式锁注解。 需求:1、参考当前pom，使用redisson 做一个分布式锁 + 看门狗续期机制的注解，同时看门狗设置最大锁持有上限，不可无限续期，防止线程卡死长期霸占锁。2、参考项目中的controller，做一个测试接口。3、启动项目，进行测试。

opencode工具有个好处，就是右边会显示代码的变更，可以看到下面的变更，全是使用openspec init 命令初始化生成的。
模型我这里就使用免费的来测试了，毕竟免费。
第一步使用 /opsx-explore 来探索需求。

如下，根据它的回复，回答对方的问题及修正对方梳理不恰当的地方。

就这样，经过多轮问答，直到觉得没有问题。输入 /opsx:propose add-yzy-mode-20260629 指令，
新增add-yzy-mode-20260629目录，在该文件夹下生成方案文档。

proposal.md — 开发动因、本次改动说明
design.md — 技术实现方案设计
tasks.md — 开发落地任务清单
openCode 右侧选择上一轮变更，可以看到新增了这几个文件。

检查下面三个文件:
proposal.md — 开发动因、本次改动说明
design.md — 技术实现方案设计
tasks.md — 开发落地任务清单
觉得不对的话，可以直接在openCode上编译。

没问题后，输入 /opsx:apply 指令，开始执行开发任务……

右边可以看到修改的代码。

现在是生成成功了，然后就是本地项目启动，测试验证。

失败了继续提问。

一直到你觉得没有问题为止。
给一个建议，如果觉得差不多的时候，建议手搓，要不然不停的问答太费时间了。
锁竞争测试成功:

锁超时测试成功:

最后执行下边这个命令进行归档:
/opsx:archive

已归档至 openspec/changes/archive/add-yzy-mode-20260629/
全局功能规范文档同步更新完毕，可开启下一个新功能需求。