SuperAPI AI 工具集

openspec-propose

通用与其它

查看项目

更新于 10-16 06:13

技能介绍

用途:当用户希望快速描述要构建或修复的内容并获得完整提案时,用本技能创建变更并一步生成全部规划制品。默认 spec-driven schema 生成 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么的增量)、design.md(如何做)、tasks.md(实现步骤)。

主要能力:依据 schema 解析需生成的制品及其依赖关系与构建顺序;从用户描述推导 kebab-case 变更名;读取上下文、规则与模板约束;按依赖顺序创建每个制品并校验文件存在;最后汇总变更名、位置与制品清单。

使用方式要点:确认变更名或描述后运行 openspec new change "<name>"(可用 --schema "<schema-name>" 指定 schema);用 openspec status --change "<name>" --json 获取 applyRequires、制品依赖与路径;对每个待建制品运行 openspec instructions <artifact-id> --change "<name>" --json,按 template 写入 resolvedOutputPath;随后重复 status 检查。若用户指定 store,先运行 openspec store list --json 获取 id,并在接受该标志的读写命令上追加 --store "<id>",且保持 sticky。查看工作流可运行 openspec context --json 后在其 root.path 下运行 openspec schemas --json;若仅返回 no_openspec_root,则直接在当前目录运行 openspec schemas --json。

适用场景:需要先形成规划、评审后再实施的变更;需要多制品协同、按依赖顺序生成的提案工作。

限制:该工作流仅授权规划,不编辑项目代码、不启动 apply;制品完成后应停止并等待新的用户请求。存在同名变更时需询问是继续还是新建。status 仅反映文件是否存在,必须依据每个制品的 requires 边构建所需集合;标记为 skipped 的制品不得创建。对影响范围、外部可观察行为、兼容性或验收标准的歧义应先询问用户,次要细节可作合理假设并记录。context 与 rules 仅供内部约束,不得写入制品文件。其他产品细节、收费与平台信息暂未提供。