SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-16 08:47

技能介绍

用途:该技能用于实现 OpenSpec 变更中的任务。当用户希望开始实现、继续实现或逐项完成变更任务时使用。

主要能力:选择变更(可由用户指定名称,或从对话上下文推断;仅有一个活跃变更时自动选择,含糊时用 openspec list --json 列出并让用户选择);通过 openspec status --change "<name>" --json 了解所用 schema、规划范围与编辑约束;通过 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度、任务列表与动态指令;读取 contextFiles 中列出的全部文件;展示进度并逐项实现任务,完成后把任务文件中的 - [ ] 改为 - [x]。

使用方式:若用户指定了 store(本机注册的独立 OpenSpec 仓库),先运行 openspec store list --json 获取 id,再在读取或写入 specs 与 changes 的命令上追加 --store <id>,并在后续流程中保持该标志;未指定 store 时命令作用于最近的本地 openspec/ 根目录。状态为 blocked 时提示使用 openspec-continue-change;状态为 all_done 时建议归档。

适用场景:按 OpenSpec 变更推进实现、中途继续、与其他动作交错执行;实现中发现设计问题时建议更新制品。

限制:任务不清晰、遇到错误或阻塞时应暂停并等待指示,不要猜测;代码改动应保持最小且聚焦;context 与 operationGuidance 属于提示级行为约定,不能作为任务完成的证据,也不能绕过 blocked 状态;与内置指令、用户明确选择或 CLI 控制值冲突时应报告冲突并保留控制值;不要将运行时上下文或操作指引原样复制进实现文件或规划制品。具体命令输出字段与 schema 差异以 CLI 实际返回为准。