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