2月8日-(OpenSpec规范)

OpenSpec规范-建立AI可理解大脑

openSpec官方网站：https://openspec.dev/

OpenSpec的核心理念就是：让AI明确知道"知识在哪里，如何用，以及为什么这样做"。

首先我们需要创建一个工作目录，生成一个标准的项目的知识骨架

# 安装依赖 npm install -g @fission-ai/openspec@latest # 创建项目 openspec init

openspec/ ├── AGENTS.md # 【大脑指令】AI 工作指南（开发规范、测试策略、错误码设计等） ├── project.md # 【长期记忆】项目上下文（目标、核心术语、文档索引） ├── specs/ # 【技能树】已实现能力的规范（做了什么） ├── changes/ # 【短期记忆】待处理的变更提案（要做什么） └── docs/ # 【知识库】详细文档（为什么这样做）

AI认识项目

索引层+明细层

索引层：（只提供项目的地图）

• AGENTS.md ：定义 AI 的核心开发规范（如命名、错误码、测试策略）。

• project.md ：阐述业务共性知识（如项目目标、核心术语、需求概要），并指明各项项详细文档在 docs/ 中的位置索引。

明细层：（这里存放这项目的架构设计，复杂的需求文档，业务逻辑说明等）。

工作流形成闭环： 当 AI 接到任务 → 先读 AGENTS.md （获取规范）→ 再读 project.md （获取业务背景）→ 根据索引定位到 docs/ 下的具体文档 → 深刻理解上下文后开始工作。

最棒的是：你无需手动编写这些索引。只需发起一个 OpenSpec 提案，通过对话引导 AI 自己去梳理项目架构和业务，它便能自动生成初始的 project.md 内容。

知识迭代提示：后续在 docs/ 下维护新知识时，需引导 AI 基于更新后的知识库，重新总结生成新的 project.md。为此，我们可以定义一个《文档管理指南》作为准则，确保 AI 每次迭代时都能遵循，从而保障业务知识的持续有效性和一致性。

常见命令：

# 创建变更提案 openspec proposal "添加记住我功能，支持30天会话" # 查看变更列表 openspec changes # 归档完成的变更 openspec archive {change-id} # 查看规范库 openspec specs