SuperAPI AI 工具集

openspec-propose

通用与其它

查看项目

更新于 10-15 23:44

技能介绍

用途:在 OpenSpec 工作流中提出新变更,一次性创建变更并生成实现所需的全部工件。输入可以是 kebab-case 变更名,或对想构建内容的描述;若输入不明确,会先询问用户想构建或修复什么,再据此推导 kebab-case 名称。

主要能力:创建变更目录(openspec new change "<name>"),通过 openspec status --change "<name>" --json 获取工件构建顺序与 applyRequires、artifacts、planningHome、changeRoot、artifactPaths、actionContext 等上下文;按依赖顺序逐个生成工件,每个工件先执行 openspec instructions <artifact-id> --change "<name>" --json 获取 context、rules、template、instruction、resolvedOutputPath、dependencies,再按 template 结构写入 resolvedOutputPath。生成内容包括 proposal.md(做什么与为什么)、design.md(怎么做)、tasks.md(实现步骤)。每完成一个工件后重新运行 status 检查,直到 applyRequires 中所有工件状态为 done。

使用方式:准备好实现时运行 /opsx:apply,或要求实现以开始处理任务。创建工件时用 TodoWrite 跟踪进度;读取已完成的依赖工件作为上下文;context 与 rules 仅作为约束,不得复制进输出文件。

适用场景:需要快速把想法转成结构化变更提案并进入实现流程时。

限制:若同名变更已存在,需询问用户是继续还是新建;若上下文严重不清,应询问用户,但优先做合理决策以保持推进;每个工件写入后需确认文件存在再继续。资料未提供收费、价格、平台支持范围等信息。