SuperAPI AI 工具集

openspec-propose

编程与开发

查看项目

更新于 11-13 09:26

技能介绍

用途

openspec-propose 用于在 OpenSpec 中提出一个新的变更:用户描述想构建或修复的内容后,该技能在一个步骤内创建变更并生成 schema 定义的全部规划产物。规划边界明确——触发该工作流的请求只授权规划,即使请求本身要求构建或修复,也不得编辑项目代码;产物完成后停止,不启动实施,等待用户在产物展示后提出新请求再进入 apply 工作流。

主要能力

在默认的 spec 驱动 schema 下,生成:

  • proposal.md:做什么与为什么
  • specs/<capability-path>/spec.md:系统必须做什么,是增量规范而非主规范;capability-path 为相对 specs/ 的目录,例如 user-auth 或 identity/user-auth
  • design.md:如何实现
  • tasks.md:实施步骤

技能会从请求中推导 kebab-case 变更名(如“add user authentication” → add-user-auth),若请求含影响范围、外部可观察行为、兼容性或验收标准的歧义则先询问用户,细节歧义可合理假设并记录在产物中。支持在已注册 store 上工作:用 openspec store list --json 发现 store id,并在读写规范与变更的命令上加 --store <id>,选定后对该工作流后续保持一致。

使用方式

输入需包含变更名或构建内容描述;若无清晰输入,技能会开放式询问“What change do you want to work on? Describe what you want to build or fix.”。随后确定工作流 schema(默认配置,除非用户明确指定 --schema),创建变更目录:

  • 默认:openspec new change "<name>"
  • 指定 schema:openspec new change "<name>" --schema "<schema-name>"

再通过 openspec status --change "<name>" --json 获取 applyRequires、artifacts 依赖边、planningHome、changeRoot、artifactPaths 等上下文,按依赖顺序逐个生成产物;每个产物先运行 openspec instructions <artifact-id> --change "<name>" --json 获取 context、rules、template、instruction、resolvedOutputPath、dependencies,重新从磁盘读取依赖产物后按模板写入;若 instruction 委托给特定技能或命令,则调用它并核验文件存在。每完成一个产物重新运行 status,直到 applyRequires 及其可达的全部产物均完成、跳过或按指示条件性跳过,最后运行 openspec status --change "<name>" 展示状态。

适用场景

适合希望快速描述想法并获得完整结构化提案、待评审后再实施的开发者;也适合在既有 OpenSpec 项目或注册 store 中统一管理变更规划。

限制

该技能仅生成规划产物,不实施变更、不启动 apply 工作流、不编辑项目代码;不要将 context、rules、project_context 等约束块复制进产物文件;schema 支持跳过条件性产物(如 design.md),specs 仅在声明 skip_specs 时跳过,不能自行判断。若同名变更已存在,需询问用户是继续还是新建。本资料未提供收费、价格、平台支持与效果数据。