AI规范编程 - openSpec

https://openspec.dev/

安装

node --version
npm install -g @fission-ai/openspec@latest
openspec --version

初始化项目

cd my-project
openspec init

在AI chat里输入下面内容：

1. Populate your project context:

"Please read openspec/project.md and help me fill it out

with details about my project, tech stack, and conventions"

2. Create your first change proposal:

"I want to add [YOUR FEATURE HERE]. Please create an

OpenSpec change proposal for this feature"

3. Learn the OpenSpec workflow:

"Please explain the OpenSpec workflow from openspec/AGENTS.md

and how I should work with you on this project"

------------

1. 完善项目背景信息：
   "请阅读 `openspec/project.md` 文件，协助我补充  
   项目详情、技术栈以及相关规范的内容" 
   
2. 撰写首份变更提案：
   "我希望新增【此处填写你要添加的功能】。请为该功能撰写一份
   OpenSpec 变更提案 "
   
3. 了解 OpenSpec 工作流程：
   "请根据 `openspec/AGENTS.md` 文件，说明 OpenSpec 的工作流程，
   以及我应当如何与你协作推进本项目"

Step 1：创建变更提案

方式一：在qwen Code中输入斜杠命令：

/openspec-proposal Custom Focus Duration
/openspec-proposal 当前学习进度页面的放到首页展示，代替"[查看我的学习进度](progress.html)", 输出md文档:全部用中文撰写

方式二：如果不用qwen-cli，输入下面内容

模拟执行：/openspec-proposal
执行过程：模拟发生 /openspec-proposal 过程中的问题提问，让我选择回答
执行范围：严格限定只更新openspec相关的文件，不要马上实现目标
更新:openspec list可以查看的进度
目标：当前学习进度页面的放到首页展示，代替"[查看我的学习进度](progress.html)"

请严格按照上述内容执行，注意：执行范围和中文输出所有md

Step 2：审查和验证

生成提案后，我可以用命令行工具审查：

# 查看活跃的变更
openspec list
 
# 验证提案格式
openspec validate add-custom-focus-duration

openspec validate integrate-progress-to-home

# 查看提案详情
openspec show add-custom-focus-duration

openspec show integrate-progress-to-home
 

Step 3：实现功能

提案审查通过后，执行实现命令：

方式一：在qwen Code中输入斜杠命令：

/openspec-apply integrate-progress-to-home

方式二：如果不用qwen-cli，我这里用的solo模式输入下面内容

执行：/openspec-apply integrate-progress-to-home
流程:严格按照openspec-apply的流程执行，先读取，再执行，最后更新 openspec 相关文档
结果: openspec list 命令，可以查看结果

完成后，当前任务有新增

如下，新增

- [] 1.8 工作进度读取和存储都使用localstore.ini文件，不再使用localStorage

执行命令

继续执行未完成的任务：/openspec-apply integrate-progress-to-home

Step 4：归档变更

所有测试通过后，执行归档命令：

/openspec-archive add-custom-focus-duration

/openspec-archive integrate-progress-to-home