用途:openspec-propose 是 OpenSpec 的规划工作流技能,用于把用户想构建或修复的内容快速转成一份完整变更提案,并在一步内生成 schema 定义的全部规划产物。它只做规划,不写项目代码。
主要能力:按默认 spec-driven schema 生成 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么的增量,而非主 spec)、design.md(怎么做)、tasks.md(实现步骤)。支持通过 --schema 指定其他工作流 schema,也支持已注册 store(用 openspec store list --json 查 id,再在读写命令上加 --store <id>,选定后保持粘性)。
使用方式:输入需包含 kebab-case 变更名或需求描述,否则先询问。核心命令:openspec new change "<name>"(可加 --schema)、openspec status --change "<name>" --json 获取 applyRequires 与 artifacts 依赖边、openspec instructions <artifact-id> --change "<name>" --json 获取模板与规则,再按依赖顺序逐个创建产物,每次创建后重跑 status。全部完成后运行 openspec status --change "<name>" 并汇总。
适用场景:需要先产出规划文档、再另行进入 apply 工作流的开发流程;希望一次拿到提案、spec 增量、设计与任务清单的团队。
限制:该工作流仅授权规划,不得实现变更、启动 apply 或编辑项目代码,产物呈现后须停下等待新的用户请求。必须创建 apply 阶段传递依赖的全部产物,而不只是 apply.requires 列出的 id;status 只反映文件是否存在,需按 requires 边判断依赖。已标记 skipped 的产物不得创建。context 与 rules 是约束,不得写入产物文件。若同名变更已存在,需询问是继续还是新建。资料未提供具体收费、平台与效果信息。