术语表
每个 OpenSpec 术语,各占一行。
OpenSpec 复用了在 git、CI 和代理工具中具有其他含义的词语。每一行给出 OpenSpec 中的含义。最后一列在可用的情况下链接到更多详细信息。
| 术语 | 定义 | 更多 |
|---|---|---|
| 应用 | 实现变更提案中的任务。技能:openspec-apply-change。 | 应用变更 |
| 归档 | 完成一个变更提案:将其增量合并到主规范中,并将其文件夹移动到 openspec/changes/archive/。 | 快速开始 |
| 工件 | 变更提案内的规划文档:proposal.md、增量规范、design.md、tasks.md。不是构建输出。 | 工件 |
| 能力 | 系统的一个行为领域。每个能力在 openspec/specs/<capability>/spec.md 处有一个规范。 | 能力 |
| 变更提案 | 一个工作单元:openspec/changes/<name>/ 下的一个文件夹,包含其规划工件。通常简称为"变更"。不是 git 提交。 | 提案 |
| 命令 | 工作流的键入入口点。拼写因工具而异(/opsx:propose、/opsx-propose)。文档改用技能来命名工作流。 | 支持的工具 |
| 继续 | 为现有变更提案创建下一个规划工件。技能:openspec-continue-change。 | 技能 |
| 交付方式 | 工作流的安装方式:作为技能、命令,或两者兼有。 | 设置项目 |
| 增量规范 | 变更提案内仅列出变更内容的规范,位于 ADDED、MODIFIED、REMOVED 和 RENAMED 标题下。 | 增量规范 |
| 探索 | 在提案前与代理一起透彻思考一个想法。不编写代码。技能:openspec-explore。 | 探索想法 |
| 快进 | 一次性创建包含所有规划工件的变更提案,可直接实现。技能:openspec-ff-change。不是 git 快进。 | 技能 |
| 旧版工作流 | OPSX 之前的 /openspec:* 命令。 | |
| 循环 | 变更提案经历的周期:探索、提案、评审、应用、归档。 | 快速开始 |
| 主规范 | openspec/specs/ 目录树:系统当前已达成一致的行为。归档会将增量合并进去。尚无规范的能力将从其 ADDED 需求中获得规范。 | 归档 |
| OpenSpec 根目录 | 命令解析并操作的 openspec/ 目录树:你的仓库的,或某个存储库的。 | 存储库 |
| OPSX | 当前的 OpenSpec 工作流系统,以及它安装的命令前缀(/opsx:)。 | |
| 配置文件 | init 安装哪些工作流:core 或 custom。 | 配置文件 |
| 提案 | 创建一个变更提案并一步生成其所有规划工件。技能:openspec-propose。 | 快速开始 |
| 注册表 | 机器级别的已注册存储库列表,位于 registry.yaml 中。不是包注册表。 | CLI |
| 需求 | 系统必须具备的一个行为,用 SHALL 编写:规范中的 ### Requirement:。 | 增量规范 |
| 场景 | 需求下的一个可测试示例,采用 WHEN/THEN 形式。 | 增量规范 |
| 模式 | 变更提案生成哪些工件以及生成顺序的定义。不是 JSON Schema。 | 模式 |
| 技能 | 工作流的指令,安装在 AI 工具读取它们的位置(.agents/skills/、...)。 | 技能 |
| 规范 | 描述某个能力当前行为的文件,位于 openspec/specs/<capability>/spec.md。 | 归档 |
| spec-driven | 默认模式:提案,然后增量规范,然后设计,然后任务。 | spec-driven |
| 存储库 | 在你机器上注册的独立 OpenSpec 仓库,用于跨仓库的规划。不是数据存储。 | 存储库(测试版) |
| 同步 | 将已实现的增量合并到主规范中,而不进行归档。技能:openspec-sync-specs。 | 技能 |
| 模板 | 模式为每个工件提供的起始内容。 | 模式 |
| 更新 | 作为技能(openspec-update-change):修订变更提案的规划工件。作为 CLI 命令(openspec update):刷新 OpenSpec 已安装的文件。 | 更新变更, CLI |
| 验证 | 在归档前检查实现是否与变更提案的工件匹配。技能:openspec-verify-change。 | 技能 |
| 工作流 | 一个命名的 OpenSpec 操作(提案、应用、归档、...),作为技能或命令安装到你的 AI 工具中。 | 设置项目 |
| 工作集 | 在一个工具中一起打开的个性化本地文件夹组。不是存储库,且不共享任何内容。 | 工作集(测试版) |