当下AI编码助手Claude Code、Cursor等的普及让开发效率迎来了质的提升但随之而来的是Vibe Coding带来的代码结构混乱、需求不明确、团队协作难等问题。而Fission-AI推出的OpenSpec框架凭借一套标准化的slash命令体系让AI编码从“随性开发”走向“规范流程化”完美解决了上述痛点。本文将基于OpenSpec官方文档为大家全面解析其核心命令体系从基础使用到进阶技巧让你轻松掌握这套能大幅提升AI编码效率和规范性的工具命令。先搞懂OpenSpec命令的两大核心体系OpenSpec的命令并非杂乱无章而是根据使用场景分为默认快速工作流core配置和扩展工作流两大体系前者满足日常快速开发需求后者适配复杂开发场景的精细化控制默认全局启用的是core配置如需开启扩展工作流执行以下两步即可运行openspec config profile选择workflows在项目中执行openspec update。两大体系的命令各有侧重先通过一张表快速了解核心命令的基础用途后续再逐一详解默认快速工作流core命令核心用途/opsx:propose一步创建变更并生成所有规划制品/opsx:explore开发前梳理思路、调研方案、明确需求/opsx:apply执行变更任务编写代码实现功能/opsx:archive归档已完成的变更留存审计痕迹扩展工作流命令核心用途/opsx:new初始化新变更的基础脚手架/opsx:continue按依赖关系逐步生成下一个制品/opsx:ff快速生成所有规划制品一步到位/opsx:verify验证代码实现与制品要求是否一致/opsx:sync将变更的增量规格合并到主规格中/opsx:bulk-archive批量归档多个已完成变更处理规格冲突/opsx:onboard交互式教程引导熟悉完整OpenSpec工作流逐个吃透OpenSpec核心命令详解所有命令均适用于AI编码助手的聊天界面且支持上下文推断部分命令可省略变更名称以下详解每个命令的语法、功能、示例和实用技巧内容均来自官方文档保证严谨性。一、默认快速工作流命令新手首选这套命令的核心是简洁高效无需关注细节一键完成核心操作适合需求明确的简单开发场景。1./opsx:propose快速启动变更的“万能入口”语法/opsx:propose [change-name-or-description]参数为非必填可传入短横线命名的变更名如add-dark-mode或自然语言描述。核心功能一步创建变更文件夹openspec/changes/change-name/并生成实现前所需的所有规划制品proposal.md、specs、design.md、tasks.md生成完成后即可进入开发阶段。示例你/opsx:propose add-dark-mode AICreated openspec/changes/add-dark-mode/ ✓ proposal.md ✓ specs/ui/spec.md ✓ design.md ✓ tasks.md Ready for implementation. Run /opsx:apply.技巧这是端到端开发最快的方式若需要对制品进行分步控制可切换扩展工作流使用/opsx:new /opsx:continue。2./opsx:explore开发前的“思路梳理器”语法/opsx:explore [topic]参数为非必填可传入需要调研的主题如移动端认证方案。核心功能无结构化的探索式对话AI会调研代码库、对比多种实现方案、绘制可视化图表帮你明确需求和技术方案调研完成后可无缝过渡到/opsx:propose默认或/opsx:new扩展工作流。示例你/opsx:explore AIWhat would you like to explore? 你How should we handle authentication for the mobile app? AILet me investigate your current auth setup... [分析代码库后给出3种方案并分析优劣]技巧需求模糊、需要调研技术方案时必用此阶段不生成任何制品可自由对比多种方案。3./opsx:apply代码实现的“执行引擎”语法/opsx:apply [change-name]参数为非必填上下文可推断时可省略。核心功能读取变更文件夹中的tasks.md识别未完成任务逐个执行并编写代码、创建文件、运行测试完成后会用[x]标记任务状态。示例你/opsx:apply AIImplementing add-dark-mode... Reading tasks.md: - [ ] 1.1 Create ThemeContext - [ ] 1.2 Add CSS custom properties [完成1.1后标记✓继续执行后续任务]技巧中断后可自动恢复执行多并行变更时可指定变更名明确执行目标任务状态全程在tasks.md中追踪。4./opsx:archive变更完成的“收尾工具”语法/opsx:archive [change-name]参数为非必填上下文可推断时可省略。核心功能检查制品和任务完成状态任务未完成会警告但不阻塞若增量规格未同步会提示同步随后将变更文件夹迁移至openspec/changes/archive/YYYY-MM-DD-name/留存所有制品作为审计痕迹。示例你/opsx:archive AIArchiving add-dark-mode... 检查制品和任务状态后提示Delta specs: Not yet synced → Sync now? (recommended) 你Yes AI✓ Synced specs to openspec/specs/ui/spec.md ✓ Moved to openspec/changes/archive/2025-01-24-add-dark-mode/ Change archived successfully.技巧归档前建议先执行/opsx:verify提前发现代码实现与制品的不一致问题。二、扩展工作流命令复杂场景必备当开发场景复杂如大型功能、团队协作需要对开发流程精细化控制时扩展工作流命令就是最佳选择核心是分步控制、全程可审。1./opsx:new变更的“脚手架初始化工具”语法/opsx:new [change-name] [--schema schema-name]两个参数均非必填未传入变更名会自动提示schema默认使用spec-driven也可在项目配置中设置。核心功能创建变更文件夹和元数据文件.openspec.yaml仅初始化脚手架不生成任何规划制品后续需通过/opsx:continue或/opsx:ff生成。示例你/opsx:new add-dark-mode AICreated openspec/changes/add-dark-mode/ Schema: spec-driven Ready to create: proposal Use /opsx:continue to create it, or /opsx:ff to create all artifacts.技巧变更名建议使用描述性名称如fix-login-bug、refactor-module避免使用update、changes等通用名称。2./opsx:continue制品的“分步生成器”语法/opsx:continue [change-name]参数为非必填上下文可推断时可省略。核心功能查询制品依赖关系图区分“已完成/可生成/被阻塞”的制品仅生成第一个可生成的制品读取依赖文件获取上下文生成后提示下一个可生成的制品。示例你/opsx:continue AIChange: add-dark-mode Artifact status: ✓ proposal (done) ◆ specs (ready) ○ tasks (blocked - needs: specs) [生成specs后提示] ✓ Created openspec/changes/add-dark-mode/specs/ui/spec.md Now available: tasks技巧复杂变更必用可在每个制品生成后审核修改避免后续大规模调整多个制品可能同时处于可生成状态。3./opsx:ff制品的“快速生成器”语法/opsx:ff [change-name]ff即Fast-forward参数为非必填。核心功能按依赖关系一次性生成所有规划制品通过待办列表追踪进度生成完成后即可进入开发阶段效果等同于/opsx:propose但基于/opsx:new的脚手架。示例你/opsx:ff add-dark-mode AIFast-forwarding add-dark-mode... ✓ Creating proposal.md ✓ Creating specs/ui/spec.md ✓ Creating design.md ✓ Creating tasks.md All planning artifacts complete!技巧需求明确的中等规模变更适用比/opsx:continue更高效生成后仍可编辑制品。4./opsx:verify开发质量的“校验器”语法/opsx:verify [change-name]参数为非必填上下文可推断时可省略。核心功能从完整性、正确性、一致性三个维度验证代码实现与制品是否匹配搜索代码库获取实现证据将问题分为CRITICAL严重、WARNING警告、SUGGESTION建议三个等级不阻塞归档但会暴露问题。验证维度详解完整性所有任务完成、需求落地、场景覆盖正确性实现符合规格意图、边缘情况处理到位一致性代码体现设计决策、编码模式统一。技巧归档前必执行可发现代码与制品的“漂移”问题警告不影响归档但建议修复避免技术债务。5./opsx:sync规格的“合并工具”语法/opsx:sync [change-name]参数为非必填上下文可推断时可省略。核心功能读取变更文件夹中的增量规格解析增/删/改/重命名内容合并到主规格目录openspec/specs/保留未提及的原有内容合并后变更仍处于活跃状态不归档。技巧此命令为可选归档时会自动提示同步仅在长周期变更、多并行变更需要最新主规格、需要单独预览合并效果时手动执行。6./opsx:bulk-archive批量变更的“归档工具”语法/opsx:bulk-archive [change-names...]参数为非必填未传入会提示选择需要归档的变更。核心功能列出所有已完成变更验证每个变更的状态检测跨变更的规格冲突通过调研代码库解决按创建时间顺序归档解决冲突后会提示合并结果。示例你/opsx:bulk-archive AIFound 3 completed changes: [列出变更及任务完成状态] Checking for spec conflicts... ⚠ add-dark-mode and update-footer both touch specs/ui/ [调研后按时间顺序合并]技巧团队协作、多并行变更时适用冲突解决基于实际代码实现归档前会主动提示确认避免覆盖规格内容。7./opsx:onboard新手的“入门教程”语法/opsx:onboard无参数直接执行即可。核心功能基于你的实际代码库的交互式教程引导完成完整的OpenSpec工作流包括代码库分析、发现优化点、创建变更、生成制品、实现代码、验证、归档等全步骤全程讲解每个操作的意义生成的是真实的变更和代码可保留或删除。技巧OpenSpec新手必用耗时15-30分钟比看文档更易上手基于真实项目而非测试示例学习后可直接应用。重要补充不同AI工具的命令语法差异OpenSpec命令的核心意图一致但在不同AI编码助手中的语法略有差异需根据使用工具调整以下是主流工具的语法格式AI工具语法示例Claude Code/opsx:propose、/opsx:applyCursor/Windsurf/opsx-propose、/opsx-applyCopilotIDE/opsx-propose、/opsx-applyTrae/openspec-propose、/openspec-apply-change注意GitHub Copilot的OpenSpec命令仅在IDE扩展VS Code、JetBrains等中可用CLI版本暂不支持自定义提示文件。兼容说明遗留命令OpenSpec保留了旧版“一步式”工作流的遗留命令仍可使用但推荐使用新版OPSX命令遗留命令及功能如下遗留命令功能/openspec:proposal一次性生成所有规划制品proposal、specs、design、tasks/openspec:apply执行变更的代码实现/openspec:archive归档已完成的变更适用场景使用旧版工作流的现有项目、无需分步控制的极简变更、偏好“一步到位”开发方式的场景。迁移说明旧版变更可直接用新版OPSX命令继续开发制品结构完全兼容无迁移成本。避坑指南常见问题及解决方案使用OpenSpec命令时可能遇到一些基础问题官方文档提供了明确的解决方案整理了4个高频问题帮你快速排障1. 报错“Change not found”原因命令无法识别需要操作的变更。解决方案① 显式指定变更名如/opsx:apply add-dark-mode② 用openspec list检查变更文件夹是否存在③ 确认当前处于正确的项目目录。2. 报错“No artifacts ready”原因所有制品均已完成或被依赖阻塞无可用生成的制品。解决方案用openspec status --change name查看阻塞原因创建缺失的依赖制品后再尝试。3. 报错“Schema not found”原因指定的工作流schema不存在。解决方案① 用openspec schemas列出可用schema② 检查schema名称拼写③ 自定义schema可执行openspec schema init name创建。4. 命令未被AI工具识别原因OpenSpec未初始化或技能未加载。解决方案① 执行openspec init初始化② 执行openspec update重新生成技能③ Claude Code需检查.claude/skills/目录是否存在④ 重启AI工具加载新技能。5. 制品生成不完整/错误原因项目上下文不足、变更描述不清晰、一次性生成过多制品。解决方案① 在openspec/config.yaml中添加项目上下文② 为制品添加专属规则③ 丰富变更描述的细节④ 用/opsx:continue替代/opsx:ff分步生成。总结选对命令让AI编码事半功倍OpenSpec的命令体系核心是**“场景化、规范化、可追踪”**通过这套命令将AI编码的“随性”转化为可管理的工作流既保留了AI编码的高效又解决了代码质量、协作、可维护性等问题。命令选择原则新手/简单需求/快速开发用默认快速工作流/opsx:propose为核心复杂需求/团队协作/精细化控制用扩展工作流/opsx:new为入口配合/opsx:continue//opsx:ff//opsx:verify需求模糊先执行/opsx:explore调研再启动变更批量完成变更用/opsx:bulk-archive高效归档并处理冲突首次使用先执行/opsx:onboard完成交互式教程。掌握OpenSpec Commands让AI编码助手成为“规范的开发助手”而非“随性的代码生成器”在提升开发效率的同时保障代码质量和项目的可维护性。