SuperAPI AI 工具集

openspec-propose

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

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

使用方式:输入需包含 kebab-case 变更名或构建描述;信息不明确时先询问。创建变更目录使用 openspec new change "<name>",指定 schema 时加 --schema "<schema-name>"。用 openspec status --change "<name>" --json 获取 applyRequires、artifacts 及其依赖边,再按依赖顺序对每个产物运行 openspec instructions <artifact-id> --change "<name>" --json,依据返回的 template、instruction、resolvedOutputPath 写文件,最后运行 openspec status --change "<name>" 汇报。若用户指定 store,先运行 openspec store list --json 获取 id,并在读取或写入规格与变更的命令上附加 --store <id>,且对该工作流其余步骤保持粘性。

限制:该工作流仅授权规划,不编辑项目代码、不启动 apply 流程,产物完成后必须停止并等待新请求。context 与 rules 仅作为约束,不应写入产物文件。文件存在状态不等于依赖已完成,需按 requires 边构建必需集合;status 为 skipped 的产物不得创建。会实质影响范围、外部可见行为、兼容性或验收标准的歧义须先询问;次要细节可合理假设并记录。若同名变更已存在,需询问继续还是新建。每条相关命令后应重新检查状态。