用途:按 OpenSpec 的实验性工件驱动方式启动一个新变更(feature、fix 或修改)。输入需包含 kebab-case 变更名,或对要构建内容的描述;若无明确输入,应询问用户想构建或修复什么,并从描述推导 kebab-case 名称(如 “add user authentication” → add-user-auth),未理解意图前不得继续。\n\n主要能力与用法:默认省略 --schema 使用默认工作流;仅当用户明确提到某 schema 名时使用 --schema <name>,提到“show workflows”或“what workflows”时运行 openspec schemas --json 让其选择。创建变更目录:openspec new change "<name>"(仅在用户要求特定工作流时加 --schema <name>),会在 openspec/changes/<name>/ 生成脚手架。随后查看工件状态:openspec status --change "<name>",显示哪些工件需创建、哪些已就绪。再获取首个工件指令:openspec instructions <first-artifact-id> --change "<name>",首个工件取决于 schema(如 spec-driven 的 proposal),可从状态输出中找状态为 ready 的工件。之后停止并等待用户指示。\n\n输出:总结变更名与位置、所用 schema/工作流及其工件序列、当前状态(0/N 工件完成)、首个工件模板,并询问是否创建首个工件。\n\n限制:此阶段仅展示指令,不创建任何工件,也不超出展示首个工件模板;名称无效(非 kebab-case)时要求提供有效名称;若同名变更已存在,建议继续该变更;使用非默认工作流时须传 --schema。
openspec-new-change
编程与开发
更新于 10-16 09:52