配置文件
选择安装哪些工作流,以及它们是以技能、命令,还是两者兼有的形式安装。
配置文件(Profile)是您对在机器上安装哪些 OpenSpec 工作流(即 AI 工具中的技能和命令)的偏好设置。默认配置文件为 core。您可以包含或排除工作流,您的选择将保存为 custom 配置文件。
核心集
core 配置文件安装六个工作流,覆盖从想法到归档的整个流程:
| 工作流 | 用途 |
|---|---|
explore | 在想法成为变更提案之前对其进行深入思考 |
propose | 创建变更提案,并一步生成其所有规划工件 |
apply | 实施变更提案的任务 |
update | 修订变更提案现有的规划工件 |
sync | 将变更提案的规范更新合并到 specs/ 中,而不将其归档 |
archive | 将完成的变更提案移至归档 |
每个工作流都链接到其完整契约:参数、创建的内容以及响应内容。
扩展集:可选工作流
核心集之外还有六个工作流可用。其中三个(new、continue、ff)会逐个工件地创建变更提案,而不是像 propose 那样一次性创建全部。
| 工作流 | 用途 |
|---|---|
new | 以空脚手架开始一个变更提案 |
continue | 在变更提案中创建下一个规划工件,一次一个 |
ff | 一次性创建变更提案及实施所需的所有规划工件 |
verify | 检查实施是否与变更提案的工件匹配 |
bulk-archive | 一次归档多个变更提案 |
onboard | 通过完成一个真实的变更提案来学习整个工作流 |
要更改此集合,请运行交互式选择器:
bash
openspec config profile选择器会询问要配置什么(交付方式、工作流,或两者),然后将全部十二个工作流列为复选框,已安装的会被勾选。任何不完全等于核心六项的选择都会保存为 custom 配置文件,因此您也可以取消勾选不使用的核心工作流。
交付方式:技能、命令或两者
交付方式是配置文件的一项设置,允许您选择只安装技能或只安装命令。默认值为 both。设置您的项目 解释了这两种形式以及它们存在的原因。该字段的确切契约见 CLI 设置 (config.json)。
两种更改方式:
交互式:运行 openspec config profile 并选择“仅交付方式”。以下是切换为仅技能:
当前配置文件设置
交付方式: both
? 您想配置什么? 仅交付方式
? 交付模式(工作流如何安装): 仅技能
配置更改:
交付方式: both -> skills
? 现在将此更改应用到当前项目? (Y/n) y直接方式:一条命令,无提示:
bash
openspec config set delivery skills # 或:both, commands交付方式永远不会更改配置文件名称。core 和 custom 仅描述工作流集合,切换回 core 会保留您的交付方式设置。
切换配置文件
切换分两步:先在您的机器上更改配置文件,然后更新每个项目以应用它。
更改配置文件:
bashopenspec config profile # 交互式 openspec config profile core # 重置为核心六项(保留交付方式)在您工作的每个项目中运行更新:
bashopenspec update
当您的当前目录是现有的 OpenSpec 项目时,交互式流程会提供在那里为您执行第 2 步的选项。