OpenSpec Skill 技能

技能简介

OpenSpec 是一套轻量、可配置的软件规格（spec）框架，专为"让 AI 编程助手按规格干活"而设计。它把你真正想构建的东西先写成规格，再让团队与编程 agent 始终对齐，随着需求演进不断修正。它被定位为"最受喜爱的 spec 框架"，在 GitHub 上已获得约 6.8 万颗星，最新版本为 v1.13.0。它的核心理念是：先建对的东西（build the right thing），再把它建对（build it right），通过规格化的探索、提案、实施、验证、归档五步工作流，把 AI 编程从"随手写代码"变成有据可依的工程闭环。

核心能力

• 规格化探索：通过 /opsx:explore 先厘清问题与代码库现状，避免盲目动手。
• 提案生成：/opsx:propose 自动生成 proposal.md、specs/、design.md、tasks.md 四件套，让需求、场景、技术方案与任务清单一次成型。
• 规格化实施：/opsx:apply 按规格中的任务清单逐条实施，进度可追踪、可勾选。
• 结果验证：/opsx:verify 检查实现是否与规格一致，保证"做对了"而不只是"做完了"。
• 变更归档：/opsx:archive 把已完成的变更归档，并同步更新规格，保持文档与代码一致。
• 广泛兼容：原生支持 Claude Code、Codex、Cursor、GitHub Copilot、Gemini CLI、OpenCode 等 38 款以上工具。

安装配置

• 通过 npm 安装：npm install -g @fission-ai/openspec（npm 包名为 @fission-ai/openspec）。
• 或在项目目录中初始化 OpenSpec，生成 openspec/ 规格目录结构。
• 按官方文档为你的编程 agent 配置对应的斜杠命令，即可在 Claude Code、Cursor 等工具中直接调用。

使用步骤

• 第一步：在项目根目录初始化 OpenSpec，建立规格管理目录。
• 第二步：运行 /opsx:explore，让 AI 帮你梳理问题、理解现有代码库。
• 第三步：运行 /opsx:propose 你的想法，生成提案、规格、设计与任务清单。
• 第四步：人工评审提案与规格，确认方向无误后再继续。
• 第五步：运行 /opsx:apply 让 AI 按任务清单实施，随后用 /opsx:verify 校验结果。
• 第六步：用 /opsx:archive 归档变更，规格自动同步，进入下一个功能。

适用场景

• 个人项目：让 AI 帮你把模糊想法整理成清晰的规格再开工。
• 团队协作：用统一规格对齐成员与 AI agent，减少理解偏差。
• 存量项目改造（brownfield）：在既有代码库上安全地添加新功能。
• 企业级开发：从个人项目平滑扩展到多人协作的工程规范。
• 需求频繁变更场景：用规格化流程让每次变更都有记录、可回溯。

适用人群

适合使用 AI 编程助手的开发者、技术负责人、产品与研发协作团队，以及希望用规格驱动开发提升代码质量的工程组织。

工作原理

OpenSpec 把开发流程标准化为"探索—提案—实施—验证—归档"的迭代闭环。规格以纯 Markdown 编写，需求配有具体场景、无需学习特殊语法。AI 负责起草规格，人来评审计划，未经确认不会直接写代码。这种方式既保留了迭代的灵活性，又避免了瀑布式的僵化，让规格成为人类与 AI 之间的"共同契约"。

官方链接

https://openspec.dev