SuperAPI AI 工具集

openspec-propose

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:该技能用于在 OpenSpec 中提出一个新变更,并在一步内生成 schema 定义的全部规划产物。默认 spec-driven schema 会生成 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么的增量)、design.md(怎么做)和 tasks.md(实现步骤)。

主要能力:从用户描述推导 kebab-case 变更名;创建变更目录;按依赖顺序生成产物;支持注册 store(通过 openspec store list --json 发现 id,并在读写命令上附加 --store <id>);支持显式指定 schema。

使用方式:先理解请求并澄清影响范围的歧义;用 openspec new change "<name>" 创建变更(可加 --schema "<schema-name>");用 openspec status --change "<name>" --json 获取 applyRequires、artifacts 及依赖边;对每个就绪产物运行 openspec instructions <artifact-id> --change "<name>" --json,读取 template、instruction、resolvedOutputPath 等,读取已完成依赖文件后写入产物;最后运行 openspec status --change "<name>" 汇总。

限制:该工作流只授权规划,禁止编辑项目代码或启动 apply 工作流;产物完成后应停止并等待新的用户请求。status 仅反映文件是否存在,需依据 requires 边构建必需集合。已标记 skipped 的产物不得创建。若同名变更已存在,需询问用户是继续还是新建。