用途:把用户在规格初次定义之后才提出的新增、删除、更正或变更请求,并入已有规范,且不隐藏变化、不复制规范来源。
前置:执行前须在项目根目录加载 $specsfy-setup;若 setup 提示有未决项则不得继续。交互方式为提问,提问前须应用 .specsfy/Spec.md 中的编号提问契约。
主要能力:定位并读取规范文件 specs/<状态>/<NNNN>-<slug>/spec.md 及其元数据、需求、场景、计划、任务、gate 与证据;读取 PROJECT.md、.specsfy/STACK.md、.specsfy/RULES.md、.specsfy/DATABASE.md 及适用的 research;检查既有 Git 改动,避免误归因。按影响分类:可逆内部修正不改规格;纯编辑澄清保留 gate;行为、验收、范围、数据、安全或接口变更从 Act I 重开;仅方案、任务或测试策略变更从 Act II 重开;与当前切片目的和角色无关的独立能力应转 $specsfy-02-backlog 或 $specsfy-03-specify。
使用方式:仅编辑 spec.md 和必要的 research,不创建 change-request.md、plan.md、tasks.md、research.md 等平行来源;保留仍有效的 ID 与决策,不重编号。行为变更在第 17 节记录原因、决策与受影响 ID。运行只读脚本评估影响:node .agents/skills/specsfy-update-spec/scripts/analyze_change.mjs specs/<状态>/<NNNN>-<slug>/spec.md --base HEAD --mode impact;用 --mode changelog 列出增删改 ID。结构校验:node .agents/skills/specsfy-04-validate/scripts/validate_spec.mjs specs/<状态>/<NNNN>-<slug>/spec.md --allow-draft。
限制:不创建新规格,不代替用户决定实质需求,不修改生产代码,不实现请求;不得在后置 gate 已批准的情况下保留被失效的输入;历史证据不得改写为新输入产生,依赖失效版本的后续证据须标为待定。