用途:以实验性的工件驱动方式启动一个新的 OpenSpec 变更,适用于用户想创建新功能、修复或修改,并希望采用结构化流程的场景。
主要能力:根据用户描述推导 kebab-case 变更名;确定工作流 schema;创建脚手架变更目录;展示工件状态与首个工件模板。
使用方式:若输入不明确,先用开放式提问确认要构建或修复的内容,并据此推导名称(如 add user authentication → add-user-auth)。默认省略 --schema,仅当用户明确指定 schema 名时使用 --schema <name>;若用户询问工作流,可运行 npx openspec schemas --json 让其选择。随后依次执行:npx openspec new change "<name>" 创建变更目录(位于 openspec/changes/<name>/);npx openspec status --change "<name>" 查看哪些工件待创建、哪些已就绪;npx openspec instructions <first-artifact-id> --change "<name>" 获取首个工件的模板与上下文。
输出与限制:完成后汇总变更名与位置、所用 schema 及其工件顺序、当前状态(0/N 完成)和首个工件模板,并提示用户可描述变更内容以起草或要求继续。此时应停止并等待用户指示,不创建任何工件,也不推进到首个工件模板之后。若名称非 kebab-case 需请求有效名称;若同名变更已存在,建议继续该变更。非默认工作流时需传 --schema。具体 schema 列表、模板内容与后续步骤细节暂未提供。