Skip to content

配置文件 ​

选择安装哪些工作流,以及它们是以技能、命令,还是两者兼有的形式安装。

配置文件(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 会保留您的交付方式设置。

切换配置文件 ​

切换分两步:先在您的机器上更改配置文件,然后更新每个项目以应用它。

  1. 更改配置文件:

    bash
    openspec config profile        # 交互式
    openspec config profile core   # 重置为核心六项(保留交付方式)
  2. 在您工作的每个项目中运行更新:

    bash
    openspec update

当您的当前目录是现有的 OpenSpec 项目时,交互式流程会提供在那里为您执行第 2 步的选项。