openspec安装

cmd或者powershell执行

检查Node.js版本（需要 >= 20.19.0）
node --version
# v22.19.0 ✓
# 全局安装OpenSpec
npm install -g @fission-ai/openspec@latest

openspec初始化

#进到项目目录内
cd 项目目录
#初始化openspec
openspec init
#初始化后当前目录中会创建出一个openspec目录
/xxxx/openspec/changes/optimize-ui-display/
├── proposal.md          # 变更概述和影响分析
├── tasks.md             # 具体实施任务清单
├── design.md            # 技术决策和设计考量
└── specs/ui-display/spec.md  # 详细的需求规范

TRAE中使用openspec

由于openspec当前实际暂未支持TRAE，需要将关键脚本(md文件)从其他初始化成功的IDE编辑器中复制到项目目录下

cp  /xxxx/项目目录/.codebuddy  /xxxxx/TRAE项目目录/.trae
#该文件夹结构及内容
ls .\.trae\commands\openspec\
Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a----        2025/10/23      8:57           1288 apply.md
-a----        2025/10/23      8:57           2006 archive.md
-a----        2025/10/23      8:57           2327 proposal.md

开始使用

其他openspec支持的IDE内使用方式，需要在AI对话助手中执行以下指令

/openspec:apply xxxxx #功能实现(xxxxx替换为openspec创建出的提案目录名)
/openspec:proposal 添加一个连接pod终端功能 #创建变更提案
/openspec:archive  xxxxx #归档变更(xxxx替换为openspec创建出的提案目录名)

TRAE中使用方式，需要在AI对话框中选择文件进行实现

openspec/changes/optimize-ui-display/
├── proposal.md          # 变更概述和影响分析
├── tasks.md             # 具体实施任务清单
├── design.md            # 技术决策和设计考量
└── specs/ui-display/spec.md  # 详细的需求规范
#该目录结构为执行proposal.md [你的需求]后会生成的文档


#AI对话框内  #号选择文件，并输入需要添加的功能或要实施的目录名
proposal.md 我想做一个类似DeepSeek 的AI 深度思考，流式文字返回的 AI 对话 Web 应用，用户可以输入问题，AI 思考之后回答。可以查看、删除 AI 和  用户的对话历史，用户也可以建立新AI对话。              #创建变更提案
apply.md optimize-ui-display    #功能实现
archive.md optimize-ui-display  #归档变更

trae内基本可用，后续openspec支持trae后忽略该文章步骤