SuperAPI AI 工具集

openspec-propose

通用与其它

查看项目

更新于 10-15 21:47

技能介绍

用途:openspec-propose 是 OpenSpec 的规划工作流技能,用于在一步内创建新变更并生成 schema 定义的全部规划产物。它只做规划,不修改项目代码;即使用户请求中包含实现或修复意图,该请求也仅授权规划。产物完成后应停止,等待用户新请求再启动 apply 工作流。

主要能力:按默认 spec-driven schema 生成 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么的增量)、design.md(怎么做)、tasks.md(实现步骤)。capability-path 为相对 specs/ 的目录,需保留已有能力的完整路径。

使用方式:输入需包含 kebab-case 变更名或需求描述,否则先询问用户。若指定了 store,先运行 openspec store list --json 获取 id,并在读写 specs 与 changes 的命令上追加 --store <id>,之后保持粘性。创建变更:openspec new change "<name>",指定 schema 时加 --schema "<schema-name>"。获取构建顺序:openspec status --change "<name>" --json,解析 applyRequires、artifacts 及其 requires 边。逐个产物获取指令:openspec instructions <artifact-id> --change "<name>" --json,按 template 写入 resolvedOutputPath,并先重读依赖产物。最后运行 openspec status --change "<name>" 汇总。

适用场景:需要快速把想法转成完整规划文档、供后续 apply 阶段实现时使用。

限制:不得编辑项目代码或启动 apply;必须创建 apply 阶段传递依赖的全部产物,而非仅 apply.requires 列出的 id;status 仅反映文件是否存在,需按 requires 边判断依赖;标记 skipped 的产物不得创建;context 与 rules 是约束,不得写入产物文件;存在同名变更时需询问用户是继续还是新建。具体 schema 名称、store 注册方式等细节以实际 CLI 输出为准。