用途:OpenSpec New Skill 用于启动一次新的 OpenSpec 变更。执行 /opsx:new 后,会在 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。
输出:含 .openspec.yaml 的 openspec/changes/<name>/ 目录。
排错:出现“Change not found”时,检查变更名是否匹配,可运行 openspec list 查看活跃变更;出现“Schema not found”时,用 openspec schemas 列出可用 schema,自定义 schema 参见 openspec-schema。
参考资料:OpenSpec 命令 /opsx:new。