Qoder的Spec模式将模糊需求自动拆解为可执行步骤：先运行qoder init --spec初始化OpenSpec结构，再在openspec/changes/下创建proposal.md明确业务目标、约束和验收标准，接着用qoder plan生成带依赖关系的任务清单，最后通过qoder quest自动执行并同步更新规范。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用自然语言描述一个模糊需求，比如“用户下单后自动发短信通知”，Qoder的Spec模式能自动把它拆成数据库建表、API接口、短信服务集成、状态机流转等可执行步骤，不需要你手动列清单或画流程图。
第一步：在项目根目录初始化OpenSpec结构
打开终端，进入你的代码仓库根目录，运行 qoder init --spec。这会自动生成 openspec/ 目录及子文件夹 specs/、changes/、schemas/ 和 config.yaml。
如果当前目录已有 package.json 或 pom.xml，Qoder会自动识别技术栈并预设对应Schema；【未检测到工程配置文件时，命令会失败且不提示原因，务必先确认项目已正确初始化】。
第二步：写一份proposal.md启动变更
在 openspec/changes/ 下新建文件夹，例如 add-sms-notify/，然后在其中创建 proposal.md。
文件内容只需三段：第一段写业务目标（如“订单支付成功后5秒内向用户手机号发送短信”），第二段写约束条件（如“不依赖第三方SaaS平台，复用现有阿里云短信SDK”），第三段写验收标准（如“短信模板含订单号、金额、时间，失败时记录error日志并触发告警”）。
这一步不能跳过——Qoder只响应有明确proposal的change，空文件夹或仅含design.md的目录会被忽略。
第三步：让Planner Agent生成任务清单
在终端执行：qoder plan --change=add-sms-notify。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
Planner会扫描整个代码库，结合proposal中的约束，输出一份带序号的tasks.md，例如：
- 新增
src/main/java/com/example/order/listener/OrderPaidListener.java，监听支付完成事件 - 修改
openspec/specs/order/spec.md，在“订单状态流转”章节追加“PAID → SMS_SENT”分支 - 在
application.yml中添加aliyun.sms.signName和aliyun.sms.templateCode配置项 - 为
SmsService添加单元测试，覆盖超时重试逻辑
每个步骤都标注了文件路径、操作类型（新增/修改/删除）和前置依赖关系。如果你发现某步缺失，直接在tasks.md里手动补充→保存→再运行 qoder plan --change=add-sms-notify --recheck 即可触发增量校验。
第四步：执行任务并同步更新规范
运行 qoder quest --change=add-sms-notify，Qoder将按tasks.md顺序自动执行所有原子步骤。
执行过程中，它会自动修改源码、提交Git暂存区、更新 openspec/specs/order/spec.md 中对应模块的增量描述，并生成PR摘要。
注意：Quest模式默认不推送远程分支，【所有改动保留在本地工作区，必须手动git push才能触发CI流水线】。
