48
// 项目简介
OpenSpec 是一个轻量级规范框架，旨在实现实施前人类意图与 AI 编码助手的对齐。它将开发变更组织为包含提案、技术设计和实施任务的结构化文件夹。该工具与 20 多种现有的 AI 编码助手集成，以提供可预测且流畅的开发工作流程。
// 技术分析
OpenSpec 是一个规范框架，旨在通过引入轻量级的、以工件为驱动的规划层，弥合人类意图与 AI 生成代码之间的差距。它通过要求开发人员在实施开始前就提案、设计和任务列表达成一致，从而解决了 AI 编码助手的不确定性。该项目优先考虑一种流畅的、迭代的理念，避免了传统文档中僵化的阶段门控，使其适用于现有项目（brownfield）和新项目（greenfield）。
// 核心亮点
01
提供了一种以工件为导向的工作流程，在编码前生成结构化的文档，如提案、设计和任务清单。
02
利用 slash commands 促进开发人员与 AI 编码助手之间的无缝交互。
03
支持超过 25 种外部工具，确保与广泛的现有开发环境和 AI 代理兼容。
04
提供了一种灵活、非僵化的架构，允许在整个开发生命周期中对规范进行迭代更新。
05
支持从个人项目到复杂的企业级应用程序的项目扩展性。
06
包含仪表板和 CLI 工具，以保持上下文的整洁，并确保人类目标与 AI 执行之间的一致性。
// 典型使用场景
01
通过工件引导的提案对齐人类与 AI 的期望
02
利用自动化任务清单和设计文档管理项目变更
03
将规范工作流程集成到现有的 AI 编码助手工具链中
// 快速开始
首先，在安装了 Node.js 20.19.0 或更高版本的系统上，使用 'npm install -g @fission-ai/openspec@latest' 全局安装该包。导航到您的项目目录并运行 'openspec init' 来设置环境。然后，您可以使用 '/opsx:propose' 命令来定义您的项目目标，从而开始工作流程。