SuperAPI AI 工具集

openspec-propose

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

用途:openspec-propose 用于在 OpenSpec 工作流中提出一个新变更,并在一步内生成该变更所需的全部规划产物。它只负责规划,不编辑项目代码,也不启动实现;即使用户请求中包含构建或修复指令,也只授权规划。

主要能力:根据配置的 schema 创建变更目录并生成产物。默认 spec-driven schema 包括 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么的增量)、design.md(如何做)、tasks.md(实现步骤)。它会按依赖顺序创建 apply 阶段传递依赖的所有产物,而不仅是 apply.requires 中列出的 ID。

使用方式:用户需提供 kebab-case 变更名或需求描述。若未提供,技能会询问“What change do you want to work on? Describe what you want to build or fix.”。随后运行 openspec new change "<name>" 创建变更,运行 openspec status --change "<name>" --json 获取产物构建顺序,再对每个产物运行 openspec instructions <artifact-id> --change "<name>" --json 获取模板与规则,写入 resolvedOutputPath。若用户指定 store,需先运行 openspec store list --json 发现 id,并在读写 specs 与 changes 的命令上追加 --store "<id>"。

适用场景:需要快速将需求转化为结构化规划文档、在实现前评审范围与设计、或使用 OpenSpec 管理变更提案的团队。

限制:仅限规划,不实现、不编辑代码、不启动 apply 工作流。产物完成后应停止,等待用户新请求再进入 apply。status 仅反映文件是否存在,不能替代依赖边判断。若变更已存在,需询问用户是继续还是新建。缺失事实:官方未提供具体收费、价格、平台或效果信息。