SuperAPI AI 工具集

openspec-propose

通用与其它

查看项目

更新于 10-16 08:47

技能介绍

用途:openspec-propose 是 OpenSpec 的规划类技能,用于根据用户描述快速创建一个新变更,并在一步内生成该变更所需的全部规划产物。它只负责规划,不修改项目代码。

主要能力:按 schema 定义生成产物。默认 spec-driven schema 包括 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么,是增量而非主 spec)、design.md(怎么做)、tasks.md(实施步骤)。支持通过 --schema 指定其他工作流,也可用 openspec schemas --json 查看可用工作流。

使用方式:用户需提供 kebab-case 变更名或想构建内容的描述,否则技能会先询问。核心命令包括 openspec new change "<name>" 创建变更目录,openspec status --change "<name>" --json 获取产物构建顺序与路径,openspec instructions <artifact-id> --change "<name>" --json 获取每个产物的模板与规则,再按依赖顺序写入 resolvedOutputPath。若使用已注册 store,需先 openspec store list --json 获取 id,并在支持的命令后追加 --store "<id>"。

适用场景:需要快速把想法转成结构化变更提案,并希望产物齐全后再进入实施阶段的项目。

限制:该工作流仅授权规划,不得编辑项目代码或启动 apply 工作流;产物完成后应停止并等待用户新请求。status 仅反映文件是否存在,需依据 requires 边判断依赖是否齐全。已标记 skipped 的产物不得创建。存在会实质影响范围、外部行为、兼容性或验收标准的歧义时应先询问用户。若同名变更已存在,需询问是继续还是新建。具体 schema 细节与命令行为以 OpenSpec 官方资料为准,本资料未提供收费、平台等信息。