SuperAPI AI 工具集

openspec-propose

通用与其它

查看项目

更新于 10-16 04:32

技能介绍

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

主要能力:根据用户描述推导 kebab-case 变更名;用 openspec new change "<name>" 创建变更目录;用 openspec status --change "<name>" --json 获取 applyRequires、artifacts 依赖边与路径上下文;按依赖顺序用 openspec instructions <artifact-id> --change "<name>" --json 获取模板与规则并逐个创建产物;最后用 openspec status --change "<name>" 输出状态。

使用方式:若用户指定了已注册 store,先运行 openspec store list --json 获取 id,并在支持该标志的命令上追加 --store "<id>",且保持粘性。需要查看可用工作流时,先 openspec context --json 解析根路径,再在该根目录运行 openspec schemas --json;显式指定 schema 时用 --schema "<schema-name>"。

限制:该工作流只授权规划,禁止编辑项目代码或启动 apply;产物完成后应停止并等待新请求。context 与 rules 是约束,不得写入产物文件。status 仅反映文件是否存在,需按 requires 边判断依赖。声明 skip_specs 的产物不得创建。存在同名变更时应询问是继续还是新建。资料未提供具体收费、平台与效果信息。