菜单
快速创建 OpenSpec 工件。当用户希望跳过逐个工件、一次性生成所有实现所需工件时使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
实现 OpenSpec 变更中的任务。当用户希望开始实现、继续实现或逐项完成任务时使用。
在实验性工作流中归档已完成的变更。适用于实现完成后的收尾归档。
批量归档多个已完成变更。适用于并行完成多个变更后的集中归档。
继续推进一个 OpenSpec 变更，创建下一个工件。当用户希望推进变更、生成下一个工件或继续流程时使用。
进入探索模式——作为思考伙伴帮助探索想法、调查问题、澄清需求。当用户希望在变更前或过程中先理清思路时使用。
使用实验性的工件工作流创建新的 OpenSpec 变更。当用户希望以结构化步骤创建新功能、修复或修改时使用。
| name | openspec-ff-change |
| description | 快速创建 OpenSpec 工件。当用户希望跳过逐个工件、一次性生成所有实现所需工件时使用。 |
| license | MIT |
| compatibility | Requires openspec CLI. |
| metadata | {"author":"openspec","version":"1.0","generatedBy":"1.1.1"} |
快速生成工件——一次性生成实现所需的一切。
输入：用户请求应包含变更名称（kebab-case），或描述他们想要构建的内容。
步骤
若输入不清晰，先问要做什么
使用 AskUserQuestion 工具（开放式，不设选项）询问：
“你想做哪个变更？请描述你要构建或修复的内容。”
从描述中生成 kebab-case 名称（例如：“add user authentication” → add-user-auth）。
重要：在理解用户要做什么之前不要继续。
创建变更目录
openspec new change "<name>"
这会在 openspec/changes/<name>/ 下创建脚手架。
获取工件构建顺序
openspec status --change "<name>" --json
解析 JSON，获取：
applyRequires：实现前必须完成的工件 ID 数组（例如 ["tasks"]）artifacts：所有工件及其状态/依赖按顺序创建工件直到可实现
使用 TodoWrite 工具跟踪工件创建进度。
按依赖顺序循环工件（先处理没有未完成依赖的工件）：
a. 对每个状态为 ready 的工件（依赖已满足）：
openspec instructions <artifact-id> --change "<name>" --json
context：项目背景（约束条件，不要写入输出）rules：工件规则（约束条件，不要写入输出）template：输出文件结构instruction：该工件类型的 schema 指导outputPath：写入路径dependencies：已完成的依赖工件，用于上下文template 作为结构创建工件文件context 与 rules 作为约束，但不要复制进文件b. 持续直到所有 applyRequires 工件完成
openspec status --change "<name>" --jsonapplyRequires 中每个工件在 artifacts 列表里是否为 status: "done"c. 若某个工件需要用户输入（上下文不清晰）：
展示最终状态
openspec status --change "<name>"
输出
完成全部工件后，总结：
/opsx:apply 或让我开始实现这些任务。”工件创建指南
openspec instructions 的 instruction 字段执行template 作为结构填充各节context 和 rules 是给你的约束，不是文件内容
<context>、<rules>、<project_context> 块复制进工件护栏
apply.requires 定义）