OpenSpec 的使用教程
OpenSpec 的使用教程 OpenSpec 是一个面向 AI 编程助手的规格驱动开发工具。它的核心思路不是一上来就让 AI 改代码，而是先把“要做什么、为什么做、怎么验收、分几步做”沉淀成文档，再让 AI 根据这些文档实施。 如果你经常让 AI 帮你改项目，应该遇到过这类问题： 一开始说的是 A，AI 改着改着变成了 B。 需求没写清楚，代码实现出来才发现方向不对。 一个会话里聊明白了，换一个新会话后上下文又丢了。 功能做完了，但没有把设计和决策沉淀下来。 OpenSpec 解决的是这个过程问题。它会把每次变更放到 openspec/changes/ 下面，用 proposal.md、design.md、specs/、tasks.md 这类文件记录上下文。这样你、AI、后续的新会话都能围绕同一套文档继续工作。 这篇文章用一个 Hugo 博客的小 demo 来讲 OpenSpec 的基本用法：假设我们想给博客新增一个“文章底部推荐阅读”功能。 1. 安装 OpenSpec OpenSpec 当前推荐使用 Node.js 环境安装。先确认本机 Node.js 版本： 1 node --version 官方文档要求 Node.js 20.19.0 或更高版本。如果版本太低，建议先通过 nvm、fnm、Homebrew 或系统包管理器升级 Node.js。 使用 npm 全局安装： 1 npm install -g @fission-ai/openspec@latest 也可以使用 pnpm、yarn 或 bun： 1 2 3 pnpm install -g @fission-ai/openspec@latest yarn global add @fission-ai/openspec@latest bun install -g @fission-ai/openspec@latest 安装完成后检查版本： ...