SuperAPI AI 工具集

openspec-apply-change

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:用于启动、继续或逐条完成某个 OpenSpec change 中的实施任务。

主要能力:可选择变更(名称省略时从对话上下文推断、只有一个活跃变更时自动选中、歧义时用 openspec list --json 列出并请用户选择);用 openspec status --change "<name>" --json 查看 schema、planningHome、changeRoot、actionContext 与任务所在 artifact;用 openspec instructions apply --change "<name>" --json 获取 contextFiles、进度、任务清单与动态指令;读取 contextFiles 中列出的所有文件后再逐条实现,每完成一条将 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/ 根。

状态处理:state 为 blocked(缺 artifact)时提示用 openspec-continue-change,或先运行 openspec status --change "<name>" --json 与 openspec instructions <artifact-id> --change "<name>" --json 查看如何创建;state 为 all_done 时祝贺并建议归档;否则进入实施。context 视为必需的提示级输入,须应用其中项目事实、约定与约束;operationGuidance 为可选附加建议,仅在不冲突且适用时遵循。二者不得当作任务完成的证据,不得绕过 blocked 状态,与内置指令、用户明确选择或 CLI 控制值冲突时应报告并以控制值为准。

适用场景:按 spec-driven 等 schema 推进实施;可在所有 artifact 完成前(若已有任务)、部分实施后或与其他动作交错调用,支持实现中发现设计问题时建议更新 artifact。

限制:任务不清、遇到错误或阻塞、实现暴露设计问题、用户中断时须暂停等待指示,不猜测;改动保持最小并聚焦单个任务;使用 CLI 输出的 contextFiles,不假设文件名;不得把运行时上下文或操作指导原样复制到实现文件或规划产物;保留 CLI 控制的 blocked/ready/all_done 行为与完成标准。