openspec-propose 是 OpenSpec 工作流中的规划技能,用途是在一步内完成新变更的全部规划产物生成。用户描述想构建或修复的内容后,该技能会创建变更目录,并按配置的 schema 生成对应产物。默认 spec-driven schema 下包括:proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么的增量规格)、design.md(如何做)、tasks.md(实现步骤)。
主要能力:从用户描述推导 kebab-case 变更名;通过 openspec new change 创建变更脚手架;通过 openspec status --change <name> --json 获取产物构建顺序与依赖关系;按依赖顺序逐个获取 openspec instructions <artifact-id> --change <name> --json 的指引,读取模板、依赖产物并写入对应路径;支持通过 --store <id> 指定已注册的存储,且在后续支持该参数的 OpenSpec 命令中保持粘性;支持显式指定 schema 或查看可用工作流。
使用方式:用户需提供变更名或描述;若存在影响范围、外部行为、兼容性或验收标准的歧义,技能会先询问;否则按合理假设记录在产物中。技能会使用待办列表跟踪产物进度,每创建一个产物后重新运行 status 检查,确保持续生成依赖链上的所有产物。完成后汇总变更名、位置、已创建产物列表及跳过原因,并提示用户运行 $openspec-apply-change(Codex)或 /openspec-apply-change(其他代理)或直接请求应用该变更。
适用场景:需要快速将想法转化为结构化规划文档的 OpenSpec 项目;希望在实现前获得完整提案、规格、设计与任务拆分的用户。
限制:该工作流仅授权规划,不编辑项目代码,不启动实现或 apply 工作流;即使初始请求要求构建或修复,也须在产物呈现后停止并等待新的用户请求;产物中的 context 与 rules 仅作为约束,不得复制进产物文件;条件性产物仅在指令标记为可选或状态为 skipped 时跳过。