用途:以实验性的工件驱动方式启动一个新的 OpenSpec 变更,适用于用户想创建新功能、修复或修改,并希望采用结构化流程的场景。
主要能力:从用户描述推导 kebab-case 变更名;确定工作流 schema(默认省略 --schema,仅当用户明确指定 schema 名时使用 --schema <name>,用户询问工作流时运行 openspec schemas --json 让其选择);创建变更目录;展示工件状态与首个工件模板。
使用方式:若输入不明确,先用开放式提问询问要构建或修复什么,未理解需求前不得继续。随后执行 openspec new change "<name>"(仅在用户指定工作流时加 --schema <name>)。接着运行 openspec status --change "<name>" --json,使用返回的 planningHome、changeRoot、artifactPaths 和 nextSteps,而非假定仓库本地路径。再根据状态输出找到首个状态为 ready 的工件,运行 openspec instructions <first-artifact-id> --change "<name>" 获取模板与上下文。
输出与限制:完成后总结变更名与位置、所用 schema/工作流及其工件顺序、当前状态(0/N 完成)、首个工件模板,并提示用户可描述变更内容或要求继续。此时不得创建任何工件,也不得推进到首个工件模板之后。名称非 kebab-case 时要求提供有效名称;同名变更已存在时建议继续该变更。
适用场景:需要结构化规划新功能、修复或修改的 OpenSpec 工作流。其他细节暂未提供。