OpenSpec规范-建立AI可理解大脑openSpec官方网站https://openspec.dev/OpenSpec的核心理念就是让AI明确知道知识在哪里如何用以及为什么这样做。首先我们需要创建一个工作目录生成一个标准的项目的知识骨架# 安装依赖 npm install -g fission-ai/openspeclatest # 创建项目 openspec initopenspec/ ├── 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