用途:在变更执行完成、进入关闭阶段之前,将变更目录 changes/<change>/ 下 specs/<capability>/spec.md 中的 delta 规格操作合并进主规格基线 specs/。changes/ 是活跃工作流来源,根 specs/ 只是已发布基线;未同步的规格会与实现不符。已处于 closing 的变更不得再路由到本技能。
主要能力:识别 ADDED/MODIFIED/REMOVED/RENAMED 四类操作;ADDED 追加需求,必要时创建规范主规格;MODIFIED 按 ### Requirement: <name> 匹配并替换描述与场景;REMOVED 删除匹配需求;RENAMED 修改需求标题。支持冲突检测:同一需求被多个未同步变更修改、RENAMED 目标与既有需求冲突时需人工解决;MODIFIED/REMOVED 指向不存在需求时标记。输出同步报告表,含能力、各操作计数与状态。
使用方式:先运行 SSF state get <change-dir> state,仅当持久化状态恰为 executing 时继续;closing 或其他状态应停止并改走 workflow-start。随后运行 SSF sync <change-dir> 检测冲突,再执行合并。注意:执行 CLI 前需把开头的 SSF 替换为 node "<plugin-root>/scripts/spec-superflow.mjs",<plugin-root> 为本文件上两级的绝对目录,不要直接运行 SSF 或调用 PATH 中的 ssf。
限制:不删除 delta 规格文件,保留用于追溯;不自动跨变更解决冲突;不合并未验证的变更;写入前校验每个候选主规格,校验失败则不写任何目标;仅语义等价且已应用的操作视为幂等无操作,近似匹配的需求名视为错误;根基线只能含 ## Requirements,不能含 delta 头;无法解释的旧式 delta-only 基线会被拒绝而非猜测。SSF sync 会自动写入发布回执,不要手动设置 spec_merged。若变更无 delta 段落,则无需发布回执。