SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:从 OpenSpec 变更中实现任务,适用于用户想开始实现、继续实现或逐项推进任务时。

主要能力:选择变更(可显式指定名称,或从对话上下文推断;仅一个活跃变更时自动选择,含糊时用 openspec list --json 列出并让用户选择);用 openspec status --change "<name>" --json 查看 schema、planningHome、changeRoot、actionContext 及任务所在产物;用 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度、任务列表与动态指令;读取 contextFiles 中列出的文件;展示进度并逐项实现,完成后把任务标记为 - [x]。

存储选择:若用户指定 store 或工作位于某个 store,先运行 openspec store list --json 发现已注册 store id,再在读写 spec 与 change 的命令(new change、status、instructions、list、show、validate、archive、doctor、context、view)上追加 --store <id>,选定后保持粘性;其他命令不接受该标志。未指定 store 时作用于最近的本地 openspec/ 根目录。

状态处理:state 为 blocked(缺少产物)时提示使用 openspec-continue-change;state 为 all_done 时祝贺并建议归档;否则进入实现。context 视为必需的提示级输入,operationGuidance 为可选附加建议,二者与 CLI 状态、任务、进度等分开,不作为任务完成证据,也不得绕过 blocked 状态;冲突时报告并保留控制值。

限制与护栏:实现前必须读取上下文文件;任务含糊、发现设计问题、遇到错误或阻塞、用户中断时暂停并等待指引;代码改动保持最小且聚焦;每完成一项立即更新复选框;不假设具体文件名,以 CLI 输出的 contextFiles 为准;不把运行时上下文或操作指引复制进实现文件或规划产物;保留 CLI 控制的 blocked/ready/all-done 行为与完成标准。该技能支持“对变更执行动作”模型,可在任意时间调用,允许在实现暴露设计问题时建议更新产物。