最受欢迎的规范框架理念是灵活而非僵化迭代而非瀑布式简便而非复杂适用于既有项目而非仅针对全新项目可从个人项目扩展到企业级应用。全新工作流现已推出用全新的工件引导式工作流重构了OpenSpec。运行 /opsx:propose 你的想法 即可开启。关注X上的 0xTab 获取更新信息加入OpenSpec Discord寻求帮助或提问。实际操作示例你输入 /opsx:exploreAI会问你想探索什么内容。你表示想实现暗黑模式但不知如何干净利落地实现AI会查看样式设置并给出最简洁的方法使用CSS变量和一个小型主题上下文并进行系统偏好检测无需引入新依赖还会问是否确定范围。你同意后输入 /opsx:propose add-dark-modeAI会创建 openspec/changes/add-dark-mode/包含 proposal.md说明为何要做以及会有哪些改变、specs/需求和场景、design.md技术方案、tasks.md实施清单。准备好实施后你输入 /opsx:applyAI会执行任务包括添加主题上下文提供者、创建切换组件、添加CSS变量、连接localStorage。所有任务完成后你输入 /opsx:archiveAI会将其存档至 openspec/changes/archive/2025-01-23-add-dark-mode/规范已更新准备好开发下一个功能。OpenSpec仪表盘快速入门需要Node.js 20.19.0或更高版本。全局安装OpenSpecnpm install -g fission-ai/openspeclatest然后导航到项目目录并初始化cd your-projectopenspec init。现在就可以和AI交流了若不确定要构建什么可从 /opsx:explore 开始它是无风险的思考伙伴能在编写代码前读取代码、权衡选项并制定计划若已明确需求可直接使用 /opsx:propose。这两个命令都包含在默认配置文件中。若需要扩展工作流/opsx:new、/opsx:continue、/opsx:ff、/opsx:verify、/opsx:bulk-archive、/opsx:onboard可使用 openspec config profile 进行选择再用 openspec update 应用配置。注意不确定工具是否受支持可查看完整列表支持25种以上工具且数量还在增加也支持pnpm、yarn、bun和nix。文档从文档主页开始涵盖了所有内容。初次使用OpenSpec先阅读快速上手再了解命令使用方法将在此实际输入 /opsx:propose。还包括快速上手入门步骤、先探索在确定方案之前使用 /opsx:explore 进行全面思考、命令使用方法斜杠命令与CLI的运行位置、核心概念概览完整的概念模型一页呈现、示例与配方完整的实际变更案例、工作流组合和模式、现有项目在既有代码库中采用OpenSpec、编辑变更更新工件、回溯、协调手动编辑、命令斜杠命令和技能、CLI终端参考、存储库在单独的仓库中进行规划供团队共享测试版、支持的工具工具集成和安装路径、概念整体架构、多语言多语言支持、自定义打造属于你的配置、常见问题解答 · 故障排除 · 术语表快速帮助。社区模式第三方模式包通过独立仓库分发这些模式提供了将OpenSpec与其他工具集成的实用工作流类似于github/spec-kit的社区扩展目录处理工具集成的方式。可在自定义文档中浏览目录。为何选择OpenSpecAI编码助手功能强大但当需求仅存在于聊天记录中时结果往往不可预测。OpenSpec增加了一个轻量级的规范层让你在编写代码之前就明确要构建的内容。优势有提前达成共识在编写代码之前人与AI就规范达成一致保持条理清晰每个变更都有自己的文件夹包含提案、规范、设计和任务灵活工作可随时更新任何工件无需严格的阶段关卡适配现有工具通过斜杠命令与20多种AI助手兼容。与其他工具对比与Spec Kit (GitHub) 对比Spec Kit全面但重量级有严格的阶段关卡、大量Markdown文件和Python设置。OpenSpec更轻量级可自由迭代。与Kiro (AWS) 对比Kiro功能强大但会被锁定在其IDE中且仅限于Claude模型。OpenSpec可与现有的工具配合使用。与无规范的AI编码对比没有规范的AI编码意味着模糊的提示和不可预测的结果。OpenSpec无需繁琐流程就能带来可预测性。更新OpenSpec升级包npm install -g fission-ai/openspeclatest。刷新代理指令在每个项目中运行 openspec update以重新生成AI指导并确保最新的斜杠命令生效。使用注意事项模型选择OpenSpec与高推理能力的模型配合使用效果最佳建议在规划和实施阶段都使用Codex 5.5和Opus 4.7。上下文管理OpenSpec在干净的上下文窗口中效果更好。在开始实施前清理上下文并在整个会话过程中保持良好的上下文管理。贡献代码小修复错误修复、拼写纠正和小改进可直接以PR形式提交。重大变更对于新功能、重大重构或架构变更请先提交一个OpenSpec变更提案以便在开始实施前就意图和目标达成一致。编写提案时要牢记OpenSpec的理念服务于不同编码代理、模型和使用场景的广泛用户群体变更应适用于所有人。欢迎使用AI生成的代码只要代码经过测试和验证即可。包含AI生成代码的PR应注明使用的编码代理和模型例如“使用Claude Code和claude-opus-4-5-20251101生成”。开发安装依赖pnpm install构建pnpm run build测试pnpm test本地开发CLIpnpm run dev 或 pnpm run dev:cli常规提交单行type(scope): subject。其他遥测OpenSpec会收集匿名使用统计数据仅收集命令名称和版本以了解使用模式不收集参数、路径、内容或个人身份信息。在CI中会自动禁用。选择退出export OPENSPEC_TELEMETRY0 或 export DO_NOT_TRACK1。维护者与顾问查看MAINTAINERS.md了解核心维护者和顾问列表他们会指导项目的发展。许可证MIT许可证