SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:从 OpenSpec 变更中实现任务。当用户想开始实现、继续实现或逐项完成某变更的任务时使用。

主要能力:选择变更(可传入变更名,如 $openspec-apply-change (Codex) 或 /openspec-apply-change (other agents) add-auth;省略时从对话上下文推断,仅一个活跃变更时自动选择,含糊则用 openspec list --json 列出并让用户选择);用 openspec status --change "<name>" --json 了解 schemaName、planningHome、changeRoot、actionContext 及任务所在产物;用 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度、任务列表与动态指令。

使用方式:读取 contextFiles 中列出的全部文件(spec-driven 为 proposal、specs、design、tasks,其他 schema 以 CLI 输出为准),展示进度后逐项实现,改动保持最小且聚焦,完成后立即把 tasks 文件中的 - [ ] 改为 - [x]。全部完成时建议归档;遇到任务不清、设计问题、错误或阻塞则暂停并等待指示。

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

限制:context 与 operationGuidance 属于提示级行为约定,不是可强制执行的检查,也不能作为任务完成的证据或绕过 blocked 状态;与内置指令、用户明确选择或 CLI 控制值冲突时应报告冲突并保留控制值。不把上下文或操作指引原文复制进实现文件或规划产物。具体平台、收费与效果资料暂未提供。