用途:该技能用于继续推进一个 OpenSpec 变更,每次调用只创建一个“下一个产出物”(artifact),帮助用户按既定工作流逐步完成变更文档。
主要能力:
- 变更选择:若用户未指定变更名,运行 openspec list --json 获取按最近修改时间排序的变更,展示最近 3-4 个选项,包含变更名、schema(无则显示 spec-driven)、状态(如 0/5 tasks、complete、no tasks)、最近修改时间,并将最近修改者标记为“(Recommended)”;要求用户选择,不自动猜测。
- 状态检查:运行 openspec status --change "<name>" --json,解析 schemaName、各产出物状态(done/ready/blocked)与 isComplete。
- 完成提示:若 isComplete 为 true,则祝贺用户并展示最终状态,提示可以实施或归档该变更,然后停止。
- 创建产出物:从状态输出中选取第一个 ready 的产出物,运行 openspec instructions <artifact-id> --change "<name>" --json,解析 context(项目背景约束)、rules(产出物规则约束)、template(输出结构)、instruction(schema 指导)、outputPath(写入路径)、dependencies(需阅读的已完成产出物)。读取依赖文件后,以 template 为结构、context 与 rules 为约束撰写内容,写入指定输出路径,然后说明创建了什么、解锁了什么,并停止。
- 全阻塞处理:若没有 ready 产出物(有效 schema 下不应出现),展示状态并建议排查问题。
- 进度反馈:创建后运行 openspec status --change "<name>" 展示所用 schema、当前进度(N/M 完成)与已解锁产出物,并提示用户可继续。
使用方式:作为 AI 编程助手的一项技能,在对话中请求“继续该变更”或“创建下一个产出物”时触发;可选择性提供变更名,未提供则由助手列出候选项供选择。
常见产出物模式(spec-driven schema:proposal → specs → design → tasks):
- proposal.md:在变更不清晰时向用户确认,填写 Why、What Changes、Capabilities、Impact;Capabilities 部分关键,列出的每项能力后续都需要一个 spec 文件。
- specs/<capability>/spec.md:为 proposal 中列出的每项能力各建一个规格文件(使用能力名而非变更名)。
- design.md:记录技术决策、架构与实现方式。
- tasks.md:将实施拆解为可勾选的任务。 其他 schema 则遵循 CLI 输出中 instruction 字段的指导。
适用场景:需要按规范工作流逐步推进 OpenSpec 变更、生成提案/规格/设计/任务等文档,并希望获得结构化进度跟踪的用户。
限制与约束:
- 每次调用只创建一个产出物。
- 创建前必须阅读依赖产出物,不得跳过或乱序创建。
- 上下文不清晰时需先询问用户。
- 写入后需确认文件存在再标记进度。
- 使用 schema 的产出物顺序,不假定具体产出物名称。
- context 与 rules 是给助手的约束,不得复制 <context>、<rules>、<project_context> 等块到产出物文件中。
- 需要本地可用的 openspec CLI 及相应命令支持;具体安装方式暂未提供。