用途:openspec-new-change 用于启动一个新的 OpenSpec 变更,采用实验性的产物驱动(artifact-driven)工作流。当用户希望以结构化方式创建新功能、修复问题或进行修改时使用。
主要能力与使用方式:
- 输入处理:用户的请求应包含 kebab-case 格式的变更名称,或包含想构建内容的描述。若未提供明确输入,技能会用 AskUserQuestion 工具以开放式问题询问:“What change do you want to work on? Describe what you want to build or fix.”,并根据描述推导出 kebab-case 名称(例如 “add user authentication” → add-user-auth)。在未理解用户要构建什么之前不会继续。
- 确定工作流 schema:默认省略 --schema 使用默认 schema;仅当用户明确要求其他工作流时,才使用 --schema <name>;若用户说 “show workflows” 或 “what workflows”,则运行 openspec schemas --json 让其选择。
- 创建变更目录:运行 openspec new change "<name>"(仅在用户要求特定工作流时附加 --schema <name>),在 openspec/changes/<name>/ 下生成所选 schema 的脚手架变更。
- 展示产物状态:运行 openspec status --change "<name>",显示哪些产物需要创建、哪些已就绪(依赖满足)。
- 获取首个产物说明:首个产物取决于 schema(例如 spec-driven 的 proposal)。根据状态输出找到状态为 “ready” 的首个产物,运行 openspec instructions <first-artifact-id> --change "<name>" 输出创建该产物所需的模板与上下文。
- 停止并等待用户指示。
输出:完成后总结变更名称与位置、所用 schema/工作流及其产物顺序、当前状态(已完成 0/N 个产物)、首个产物模板,并提示:“Ready to create the first artifact? Just describe what this change is about and I'll draft it, or ask me to continue.”
限制与护栏:此时不创建任何产物,仅展示说明;不推进到展示首个产物模板之后;若名称无效(非 kebab-case)则要求提供有效名称;若同名变更已存在,建议继续该变更;使用非默认工作流时须传 --schema。其他如收费、平台支持等信息暂未提供。