人工智能AI 应用开发工具CLIAI Agentdsh-pluginDeepSeek【免费下载链接】ccg-workflow多模型协作开发系统 - Claude 编排 Codex 后端 Gemini 前端28 个命令覆盖开发全流程一键安装零配置项目地址https://gitcode.com/fengshao1227/ccg-workflow点击查看免费下载导读本文深入剖析 ccg-workflow 仓库中 OpenSpecOPSX技能集的核心成员 ——.agents/skills/openspec-ff-change/SKILL.md。该技能实现快进fast-forward式变更流程跳过逐件创建 proposal、specs、design、tasks 等 Artifact 的繁琐步骤一次会话内按依赖顺序批量生成全部实施所需文档让开发工作直接从想法跳到可动手写代码。读完本文你将掌握 ff-change 的完整 CLI 调用链、openspec instructions --json返回字段的语义、Artifact 创建纪律与 Guardrails并理解它在 ccg-workflow 的 OPSX 命令体系/ccg:spec-init→/ccg:spec-plan→/ccg:spec-impl中所处的位置。OpenSpec 快进模式为什么需要一次性生成OpenSpec 的常规new-change流程强调分步推进每轮只创建一个 Artifact然后停下来向用户确认方向。.agents/skills/openspec-new-change/SKILL.md明确要求 Do NOT create any artifacts yet - just show the instructions这种节奏适合需求尚未收敛的场景。但当用户已经清楚要做什么时逐件确认反而成为摩擦。ff-change 技能定位正是与之互补的快车道generate everything needed to start implementation in one go一次生成开始实施所需的全部内容。它保留 OpenSpec 的核心约束——按 Schema 定义的依赖顺序产出 Artifact、不跳过任何环节——同时将创建 → 确认循环压缩为一条流水线。从 技能路由规则 与 templates/CLAUDE.md 可以看到OPSX 系列共 5 个 CCG 封装命令/ccg:spec-init、/ccg:spec-research、/ccg:spec-plan、/ccg:spec-impl、/ccg:spec-review而.agents/skills/下则存放着 10 个底层 OpenSpec 技能。ff-change 属于后者中的动作型技能负责在spec-plan阶段把需求快速转译为规范文档供后续spec-impl消费。输入约定一个变更名或一段需求描述ff-change 的输入要求与 new-change 一致The users request should include a change name (kebab-case) OR a description of what they want to build.两种输入形态对应两条路径显式名称用户直接给出 kebab-case 变更名如add-user-auth直接进入创建环节需求描述用户描述要构建/修复的内容技能通过AskUserQuestion tool开放式问题、不预设选项澄清需求然后从描述中提炼 kebab-case 名称。例如 add user authentication →add-user-auth。技能对此有一条硬性约束Do NOT proceed without understanding what the user wants to build在理解用户意图之前不得继续。这避免了在需求模糊时盲目生成一堆没人要的文档。如果同名变更已存在则应建议继续该变更而非新建——防止openspec/changes/下出现命名冲突。核心流水线四步到达 apply-readyff-change 的主流程由四个阶段构成每步都对应具体的 openspec CLI 命令。第 1 步创建变更目录openspec new change name该命令在openspec/changes/name/下搭建变更脚手架。注意这里默认使用 Schema省略--schema只有用户明确要求特定工作流时才追加--schema name——这与 new-change 技能的默认 Schema 优先原则完全一致。第 2 步获取 Artifact 构建顺序openspec status --change name --json解析 JSON 输出可获得两个关键字段applyRequires实施前必须完成的 Artifact ID 数组例如[tasks]——这是 ff-change 的终止条件artifacts全部 Artifact 列表包含各自的statusdone/ready/blocked与依赖关系。applyRequires由 Schema 的apply.requires定义见下文 Guardrails它决定了快进的终点只生成到可以开始实施为止而非生成全部 Artifact。对于 spec-driven Schema终点通常是tasks.md。第 3 步按依赖顺序循环创建 Artifact核心循环逻辑为依赖已满足的 Artifact 优先artifacts with no pending dependencies first。每处理一个ready状态的 Artifactopenspec instructions artifact-id --change name --json返回的 instructions JSON 包含六个字段语义如下字段含义使用方式context项目背景约束仅作为写作约束禁止写入输出文件rulesArtifact 专属规则仅作为写作约束禁止写入输出文件template输出文件的结构骨架作为文件结构逐节填充instruction该 Artifact 类型的 Schema 级指导决定内容怎么写outputPathArtifact 的写入路径按此路径落盘dependencies已完成的依赖 Artifact写前必读作为上下文流程细节先读依赖读取dependencies列出的已完成 Artifact 文件获取上下文按模板创建以template为结构、instruction为指导生成文件写入outputPath约束不外泄context与rules指导写作但绝不能复制进文件详见下文三大纪律进度回显每完成一个 Artifact 输出✓ Created artifact-id。创建每个 Artifact 后重新执行openspec status --change name --json检查applyRequires中的每个 ID 在artifacts数组里是否都已status: done全部完成即停止。第 4 步展示最终状态openspec status --change name收尾时向用户汇总变更名称与位置、已创建 Artifact 清单及简述、就绪声明All artifacts created! Ready for implementation.并给出衔接提示Run/opsx:applyor ask me to implement to start working on the tasks.输出汇报模板技能在完成全部 Artifact 后要求 Agent 输出结构化总结包含三块信息Change name and location—— 变更名与openspec/changes/name/路径List of artifacts created with brief descriptions—— 每个 Artifact 的一句话说明Whats ready—— 就绪声明 下一步提示。这套汇报格式与 openspec-apply-change 的## Implementation Complete输出模板、openspec-continue-change 的进度汇报形成呼应ff-change 负责造好弹药apply-change 负责扣动扳机。Artifact 创建三大纪律技能用一节专门强调创建规则核心是约束是给 Agent 的不是给文件的内容跟随instruction每个 Artifact 类型都有 Schema 定义的内容规范必须遵循先读依赖再写创建新 Artifact 前必须读取依赖 Artifact 获取上下文template是骨架用模板结构填充输出文件逐节完成。其中最容易被忽视的是最后一条红线Do NOT copycontext,rules,project_contextblocks into the artifact。这三类块是写作时的隐性约束指导你应该写什么、怎么写一旦被原样抄入 Artifact就会污染规范文档把项目背景说明误当成需求正文。从 openspec-sync-specs 的 Delta Spec 格式参考可以看出规范正文应该以SHALL型需求句 WHEN/THEN场景构成——这正是template和instruction引导 Agent 产出的目标形态而非杂糅约束说明的草稿。Guardrails快进的刹车系统ff-change 的 Guardrails 是流水线的安全边界共五条创建全部实施所需 Artifact以 Schema 的apply.requires为准缺一不可——快进不等于偷工减料始终先读依赖 Artifact杜绝凭空写规范上下文严重不清时询问用户但倾向做合理决策以保持推进节奏prefer making reasonable decisions to keep momentum同名变更已存在时建议继续旧变更而不是制造重复目录写后验证每个 Artifact 文件写完都必须确认真实存在再进入下一个——防止自以为写了但没落盘。第 5 条尤为关键outputPath可能嵌套多层如openspec/changes/name/specs/capability/spec.mdAgent 必须显式验证文件存在与 openspec-continue-change 的 Verify the artifact file exists after writing before marking progress 是同一条纪律在两个技能中的复现。与相邻技能的衔接快进不是孤立动作ff-change 处于 OpenSpec 技能生态的中间环节理解它的完整价值需要看它前后相邻的技能技能角色与 ff-change 的关系openspec-explore探索模式纯思考、不写代码想法结晶后可转入/opsx:new或/opsx:ffff 是探索的出口之一openspec-new-change分步创建一次一个 Artifactff 是它的极速版跳过逐件确认openspec-continue-change续作创建下一个 Artifact 后停下与 ff 共用instructions --json字段语义但一次只推进一个openspec-apply-change实施读取 tasks 逐个实现ff 的applyRequires完成后即衔接此处openspec-sync-specs / openspec-archive-change同步 / 归档实施完成后的收尾环节值得注意的一点是 apply-change 技能中的 Fluid Workflow Integration 描述变更上的各动作可以在任何阶段交错调用not phase-locked, work fluidly。这意味着 ff-change 的快进并不与分步互斥——用户可以在探索中突然要求快进某个已经清晰的变更也可以在快进完成后暂停、修改某个 Artifact 再继续。在 ccg-workflow 项目中的落地OPSX 封装视角ccg-workflow 仓库将 OpenSpec CLI 包装为 5 个 CCG slash 命令templates/CLAUDE.md。ff-change 技能对应的落地场景是/ccg:spec-plan多模型分析 → 消除歧义 → 零决策可执行计划阶段当需求经 research 收敛后Agent 可调用 ff-change 一次性产出 proposal / specs / design / tasks供 spec-impl 命令 中的/opsx:apply内部调用消费。spec-init 命令 提供了 ff-change 的前置环境要求OpenSpec CLI 的安装与验证方式npm install -g fission-ai/openspeclatest或npx fission-ai/openspecNode.js ≥ 18以及初始化命令npx fission-ai/openspec init——这是运行openspec new change之前必须完成的准备工作。同时注意 spec-impl 命令 的 USER GUIDANCE RULE面向用户时永远建议 CCG 命令/ccg:spec-*而不是/opsx:*且tasks.md中所有任务必须使用 checkbox 格式- [ ] X.Y description否则 OpenSpec CLI 会解析出 0 个任务并阻塞整个工作流——这也解释了为什么 ff-change 的循环终止条件要严格依赖applyRequires的状态检查而不是凭主观判断差不多齐了。小结openspec-ff-change 技能的本质是把 OpenSpec 的规范驱动工作流从逐件手搓升级为流水线批量生产一次输入、四步 CLI 调用、按依赖顺序循环创建 Artifact直到applyRequires全部满足。它的价值不在省掉文档而在用规范化的模板与约束把模糊需求快速变成可实施、可验证、可追踪的任务清单随后无缝衔接/opsx:apply进入多模型实施阶段。对于希望让 AI 驱动的开发既保持 OpenSpec 的规范严谨性、又不牺牲推进速度的团队ff-change 是值得优先接入的技能入口。赞分享人工智能AI 应用开发工具CLIAI Agentdsh-pluginDeepSeek【免费下载链接】ccg-workflow多模型协作开发系统 - Claude 编排 Codex 后端 Gemini 前端28 个命令覆盖开发全流程一键安装零配置项目地址https://gitcode.com/fengshao1227/ccg-workflow点击查看免费下载相关推荐OPSX Fast Forward 工作流详解/opsx:ff 命令如何一键生成 OpenSpec 变更制品OPSX Fast Forward 工作流详解/opsx:ff 命令如何一键生成 OpenSpec 变更制品 导读 本文以 Rivet Actors 仓库中后端AI Agent人工智能流程编排WebSocketDruid 仓库 OpenSpec 变更实施指南openspec-apply-change 技能工作流全解析Druid 仓库 OpenSpec 变更实施指南openspec apply change 技能工作流全解析 本指南围绕仓库内 .cursor/skills/数据库后端Druid 仓库中的 OpenSpec Fast-Forward一键生成实现就绪工件的 AI 技能实践指南Druid 仓库中的 OpenSpec Fast Forward一键生成实现就绪工件的 AI 技能实践指南 导读 本文讲解 .cursor/skills/op数据库后端上一篇YimMenu终极教程GTA5免费辅助工具完整配置与安全使用指南下一篇实战指南5个关键技术点掌握《鸣潮》AES加密模组开发创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考