用途:OpenSpec New 用于启动一个新的 OpenSpec 变更。它会在 openspec/changes/<name>/ 下创建变更目录结构,写入元数据(.openspec.yaml),并准备创建第一个工件。适用于开始新功能、缺陷修复或重构,或用户说“start a change”“new feature”“new OpenSpec change”时;也适合在用 openspec-explore 探索想法并决定要构建什么之后使用。
前提:项目已初始化 OpenSpec(参见 openspec-initial)。
用法:执行 /opsx:new <change-name>,例如 /opsx:new add-dark-mode;也可用 /opsx:new <change-name> --schema <schema> 指定工作流 schema(默认 spec-driven)。若未提供名称,智能体会提示输入。
创建内容:openspec/changes/<name>/ 目录,以及 openspec/changes/<name>/.openspec.yaml(包含 schema、创建日期等变更元数据)。
后续步骤:智能体会显示第一个待创建工件(通常是 proposal)。可用 openspec-continue 逐个创建工件,或用 openspec-ff 一次性创建全部规划工件。
命名约定:使用描述性名称,如 add-dark-mode、fix-login-bug、refactor-auth;避免 update、changes、wip 等泛化名称;使用 kebab-case。
排错:“Change not found”时检查变更名是否匹配,可运行 openspec list 查看活动变更;“Schema not found”时用 openspec schemas 列出可用 schema,自定义 schema 参见 openspec-schema。
限制:资料未提供收费、价格、平台支持范围等信息。